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ABSTRACT 

This  thesis  is  a  summary  of  the  design  and  implementa- 
tion  of  a  user  interface  for  a  color,  raster-scan  graphics 
display  device.  The  problems;  solutions  and  a  general  set 
of  guidelines  related  to  designina  an  interface  for  a  color 
capable  graohics  device  are  discussed.  The  implementation 
of  a  software  interface  for  a  ^A^TEK  GX-100A  with  the 
PDP-ll/50  computer  is  presented.  The  interface  is  imole- 
mented  within  the  conventions  of  the  C  programming  language 
and  executes  under  the  UNIX  operating  system.  Recommenda- 
tions for  further  exoansion  of  the  interface  are    discussed. 
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I.   INTRODUCTION 


This  thesis  is  the  design  and  implementation  of  a  user 
interface  for  a  color,  raster-scan  display  device*  specifi- 
cally the  RAMTEK  GX-100A.  The  basic  design  and  operation  of 
the  device  as  implemented  in  the  Naval  Postgraduate  School 
Computer  Laboratory  is  discussed. 

The  actual  design  and  operation  of  the  interface  is 
presented  as  well  as  the  oroblems  which  were  considered  in 
its  design  and  construction.  The  main  consideration  in  the 
design  of  the  interface  was  how  to  effectively  implement  the 
use  of  color  in  a  graphic  display. 

The  concept  of  a  color  triple  and  color  cube  are  intro- 
duced as  natural  extensions  of  the  method  used  by  color 
graphics  devices.  However,  the  triple  and  cube  are  strictly 
defined  by  limitations  in  the  hardware  that  restrict  the 
number  of  colors  that  can  be  generated  to  409b. 

A  user's  manual  was  written  to  enable  the  user  to  util- 
ize the  interface  from  a  program  written  in  the  high  level 
language,  C  [11/  supported  by  the  UNIX  operating  system  on 
the  PDP-11/50.   It  is  included  in  Appendix  A. 


II.   GENERAL  DESCRIPTION  OF  RASTER  SCAN  DEVICES 

The  cathode  ray  tube  is  the  most  widely  used  graphics 
display  device  today.  It  consists  basically  of  an  electron 
gun  which  projects  a  beam  of  electrons  onto  a  screen  which 
has  a  phosohor  coating.  The  phosohor  is  excited  when  struck 
by  the  beam  of  electrons  and  emits  visible  light  which  is 
perceived  by  the  viewer.  Due  to  the  short  persistence  of 
the  phosphor  utilized  on  most  cathode  ray  tubes,  it  is 
necessary  to  repeatedly  excite  it  to  minimize  fading  of  the 
image  and  reduce  visible  flicker.  There  are  two  basic 
methods  used  to  refresh  a  display.  The  first  is  to  directly 
trace  the  image  beina  oroduced  several  times  a  second  with 
the  electron  beam  turned  on.  The  second  is  to  scan  the 
entire  screen  with  the  beam,  while  only  turning  the  beam  on 
and  off  when  desired  to  oroduce  the  image.  The  second  is 
known  as  the  raster  scan  technique.  It  is  the  same  tech- 
nique used  in  commercial  television  sets. 

In  raster  scan  devices,  the  screen  is  divided  into  lines 
and  elements.  Lines  extend  horizontally  across  the  screen 
and  elements  are  discrete  Dositions  on  a  line.  A  soecific 
element  on  a  soecific  line  is  called  a  Dixel.  Figure  1 
illustrates  the  relationship  of  lines,  pixels  and  elements 
to  each  other  and  the  screen.  The  number  of  oixels  deter- 
mines the  resolution  of  the  screen.  The  more  pixels,  the 
higher  the  resolution  of  the  picture. 
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Figure  1 


The  added  feature  of  color  in  a  raster  scan  device  re- 
quires the  addition  of  two  more  electron  guns  and  a  more 
complicated  phosphor  coating  on  the  screen.  The  phosphors* 
representing  the  primary  colors  of  blue/  green  and  red  are 
located  in  each  oixel  area  and  are  called  a  triad.  The 
three  guns  are  used  to  produce  three  electron  beams  to  scan 
the  screen.  These  beams  are  independently  varied  in  intensi- 
ty to  excite  any  one/  two  or  three  ohosohors  to  produce  the 
desired  color. 

In  order  for  an  image  to  be  drawn  in  color/  not  only 
must  the  electron  guns  be  turned  on  and  off  at  the  oro'oer 
locations/  out  the  combination  of  beams  and  the  intensity  of 

1  1 


each  must  be  adjusted  to  Droduce  the  color. 


III.   THE  RAMTEK  GX-100A  GRAPHICS  DISPLAY 

The  RAMTEK  is  an  interactive*  raster-scan*  color  graph- 
ics display  device.  It  consists  of  a  bi-directional  inter- 
face* a  display  generator*  solid  state  memory*  a  video  look- 
up table*  device  multiplexor*  keyboard*  cursor  generator* 
video  generator*  and  a  cathode  ray  tube  [21 .  Figure  2  il- 
lustrates the  relationship  of  the  hardware  and  the  component 
parts'  relationships  with  each  other. 

A.  BI-DIRECTIONAL  INTERFACE 

The  bi-directional  interface  connects  the  PDP-11  with 
the  video  lookup  table*  display  generator  and  the  device 
multiplexor.  The  interface  establishes  data  paths  to  and 
from  the  CPU  and  the  device  multiplexor*  the  video  lookup 
table*  and  the  display  generator. 

B.  DEVICE  MULTIPLEXOR 

The  device  multiolexor  interconnects  with  the  cursor 
generator  and  the  keyboard.  It  enables  the  CPU  to  receive 
data  via  the  RAMTEK  keyboard. 

The  keyboard  converts  the  keystrokes  into  extended  ASCII 
character  codes  which  are  transmitted  to  the  device  multi- 
p 1 exor . 
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C.  DISPLAY  GENERATOR 

The  display  generator  contains  the  standard  ASCII  char- 
acter codes  and  hardware  logic  such  that  dot-matrix  charac- 
ter patterns  are  generated  and  passed  to  the  memory.  It 
also  takes  input  data  and  processes  it  according  to  the 
instructions^  received  and  writes  the  aporooriate  data  into 
the  memory  so  the  proper  image  will  be  displayed. 

D.  MEMORY 

The  organization  of  the  solid  state  refresh  memory  is 
the  kev  to  the  operation  of  the  RAMTEK.  The  memory  consists 
of  up  to  eight  memory  boards  (planes)  which  have  the  capaci- 
ty to  store  512  lines  by  640  elements.  The  RAMTEK  used  in 
this  work  has  four  memory  planes  and  an  effective  address 
space  of  240  lines  by  640  elements. 

As  illustrated  by  figure  3  /  the  memory  can  be  viewed  as 
a  three  dimensional  structure  with  the  x-axis  co r reSDond i ng 
to  the  elements/  the  y-axis  correspond  ina  to  the  lines  and 
the  z-axis  corresponding  to  the  display  subchannels. 

The  display  subchannels  reoresent  a  binary  pointer  into 
the  video  lookup  table  by  only  oermitting  certain  planes  of 
memory  to  be  written  in.  Thus  the  binary  code  on  a  certain 
z-axis  represents  the  pointer  into  the  video  lookup  table. 
This  establishes  the  color  to  be  displayed  at  that  location 
on  the  screen.  For  example*  if  the  z-axis  at  line  five/ 
element  56  contains  a  0101/  the  pointer  into  the  video  look- 
up table  points  to  entry  five. 
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E.  VIDEO  GENERATOR 

The  video  generator  reads  the  information  stored  in  the 
refresh  memory  and  generates  the  comoatable  signals  for  the 
cathoae  ray  tube  (CRT)  to  disolay  the  image  on  the  screen. 

F.  VIDEO  LOOKUP  TABLE 

The  video  lookuD  table  is  the  center  of  the  color  gen- 
erating caoability  of  the  R A M T E K .  It  contains  sixteen  arbi- 
trary colors  from  address  zero  to  fifteen  in  the  table.  As 
described  aoove?  the  combination  of  memory  olanes  enabled 
by  the  selected  subchannels  reoresents  the  pointer  to  an 
entry  in  the  video  lookuo  table.   Each  entry   in   the   video 
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lookup  table  consists  of  a  twelve-bit  code  broken  into  three 
four-bit  binary  fractions  which  correSDond  to  intensities 
of  blue/  green  and  red.  As  illustrated  in  figure  4,  bits 
zero  through  three  reDresent  red/  four  through  seven 
represent  green  and  eight  through  eleven  represent  blue. 
Therefore/  any  of  4096  colors  can  be  represented  in  the 
twelve  bits.  Only  sixteen  colors  can  be  disDlayed  on  the 
screen  at  any  one  time  because  having  four  planes  of  memory 
to  represent  the  oointer  to  the  viaeo  lookup  table  limits 
the  oointer  value  to  zero  through  fifteen. 
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V  i  deo  Lookup  Table 
Fiaure  4 
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IV.   POSITIONAL  ADDRESSING 

There  are  three  methods  of  addressing  the  RAMTEK  screen; 
absolute?  indexed  and  relative.  As  stated  earlier,  address- 
ing a  raster  scan  device  is  accomplished  by  spec i f i ng  the 
line  and  element  number  which  indicate  the  address  of  a 
pixel  on  the  screen. 

Because  of  the  low  line  resolution  of  the  device  used, 
only  even  lines  are  aadressable.  Therefore  the  line  ad- 
dressing is  from  zero  to  480  where  zero  and  one  address  the 
same  line,  two  and  three  address  the  same  line  and  so  on. 
The  address  that  is  currently  being  referred  to  is  known  as 
the  current  operating  ooint  CCOP).  It  is  like  a  oointer  to 
a  location  on  the  screen  where  the  next  entity  will  be 
di  spl ayed. 

A.   ABSOLUTE  ADDRESSING 

By  specifying  a  line  and  element  number,  a  single  pixel 
is  addressed  in  the  same  way  as  a  point  is  addressed  in  a 
cartesian  coordinate  system.   The  COP  is  at  that  pixel. 


B.   INDEXED  ADDRESSING 

The  RAMTEK  provides  two  index  registers  which  can  be 
used  in  addressing  the  RAMTEK  screen.  To  address  a  location 
using  index  registers,  the  specified  line  and  element 
numbers  are  summed  with  the  contents  of  the  line  and  element 
index  registers  to  yield  the  address  of  a  pixel  on  the 
screen.  For  example,  if  the  specified  address  is  line  100, 
element  200  and  the  line  and  element  index  registers  contain 
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26   and  30  respectively,  the  resulting  address  (COP)  is  line 
126,  el ement  1  30  . 

C.   RELATIVE  ADDRESSING 

This  method  takes  the  specified  line  and  element  numbers 
and  considers  them  to  be  displacements,  that  is,  the  number 
of  lines  and  elements  to  add  to  the  COP  address  to  yield  a 
new  COP.  For  example,  if  the  specified  displacements  are  20 
lines  and  30  elements,  and  the  COP  is  line  100,  element  1^0; 
the  new  COP  is  line  120,  element  170. 


V.   CONTROL  MODES 

The  RAMTEK  operates  in  any  one  of  eight  control  modes 
[ 2 ] .  Each  control  moae  can  be  modified  by  selected  control 
flags.  The  modes  and  their  applicable  control  flags  are 
summarized  in  Tables  I  and  II.  More  detailed  descriptions 
of  the  modes  and  how  they  work  are     located  in  Appendix  A. 
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TABLE  I 
CONTROL  MODE  DEFINITIONS 


Mode 


Functional  Description 


Alohanumeric   Data 


T  ransverse   Data 


Raster  Data 

Como lex    Data 

Graph  i  c   Vector 
Graph  i  c   Plot 


Graphic   Cartesian 


Graph  i  c  El emen  t 


Writes  alphanumeric  characters 
on  the  sc  reen . 

Decodes  the  data  as  a  single  bit 
oer  pixel  ana  writes  the  data  in 
an  eight  pixel  wide  vertical 
column  from  too  to  bottom. 

Same  as  Transverse  data  but 
writes  left  to  right  on  the  same 
line. 

Decodes  the  data  as  four 
bits  oer  pixel  and  writes  left 
to  right  on  the  same  line. 

Draws  continuous  lines  between 
arbitrary  end  points. 

Draws  a  histogram  style  plot  by 
drawing  continuous  lines  between 
successive  y-axis  points  while 
incrementing  the  x-axis  from 
left  to  riaht. 

Draws  solid  rectangles  be- 
tween arbitrary  end  ooints. 

Draws  a  dot  at  specified  point. 
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TABLE  II 
CONTROL  FLAG  DEFINITIONS 


Name 


Functional  Description 


Index  Address  i  ng 


Reverse  Background 


Additive  Write 


Doubl e  Width 


Fixed  Point 


Causes  indexed  addressing  to  be 
in  effect . 

Causes  ones  written  in  memory  to 
become  zeros  and  vice-versa. 

Causes  the  new  image  to  written 
"on  top"  of  the  existing  image. 

Doubles  the  width  of  generated 
data  by  writing  each  bit  of  data 
into  two  elements  instead  of 
one . 

Uses  the  point  defined  bv  the 
contents  of  the  line  and  element 
index  registers  as  the  starting 
point  for  each  graphic  entity. 


VI.   SPECIAL  FUNCTIONS 


There  sre  two  special  functions  which  alter  the  display. 
The  first  is  the  erase  instruction  and  the  second  is  the 
scroll   function. 

The  erase  function  simoly  writes  all  zeros  or  ones  into 
memory  depending  on  the  state  of  the  background  flag  in  the 
control  mode  and  the  subchannels  selected. 

The  scroll  function  creates  a  moving  window  effect  by 
moving  the  image  vertically  for  a  specified  number  of  lines. 
A  positive  or  negative  number  inaicates  which  direction  the 
image  will  move.  Images  that  arp  scrolled  off  the  top  of 
the  screen  re-enter  the  bottom  and  vice-versa. 
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VII.   GENERAL  USER  INTERFACE  DESIGN 

One  of  the  governing  constraints  in  developing  software 
for  graphics  outout  is  the  fact  that  it  is  harder  to 
describe  a  picture  than  it  is  to  describe  a  table  of  words 
o r  numbe rs. 

For  this  reason,  some  of  the  normal  principles  of  good 
system  design  apoly  with  exceptional  force.  The  user  who 
has  the  job  of  describing  a  picture  must  be  provided  with  a 
set  of  instructions  and  graphic  tools  that  enable  him  to 
concentrate  on  the  image  he  wishes  to  create.  The  user  must 
not  be  distracted  by  irritating  details  imposed  by  the 
peculiarities  of  the  hardware.  He  must  be  allowed  to  ex- 
press algorithims  as  he  conceives  them,  and  be  able  to  trace 
and  correct  errors  with  a  minimum  of  trouble.  It  is  essen- 
tial that  the  graphics  system  be  simole  to  orogram  (31. 

An  excellent  general  approach  to  designing  a  user  inter- 
face for  graphics  systems  is  expressed  by  Wagner  and  LaHood 
[31.  It  describes  some  general  guidelines  in  which  a  level 
st  rue  t  u  re  is  built. 

A.   MULTILEVEL  STRUCTURE 

A  multilevel  design  is  based  on  building  blocks  which, 
at  the  lower  levels,  involve  efforts  to  provide  an  efficient 
interface  between  the  computer  and  the  graphic  device. 
Higher  levels  of  software  are  then  developed  to  increase  the 
productivity  of  the  total  system.  Routines  on  the  lower 
levels  are  dependent  on  hardware,  but  as  levels  increase, 
the  deoendence  on  haraware  decreases,  and  the  complexity   of 
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the  functions  performed  by  software  increases.  At  the 
highest  level  the  routines  are  totally  independent  of 
hardware . 

1.  Level  I  -  Primitive  Hardware  Oriented  Subroutines 
Level   I   routines  are     intimately  concerned  with  the 

hardware  characteristics  of  the  device.  These  form  the 
basis  for  building  Level  II  routines.  Examples  are  primitive 
display  command  utilities,  display  instruction  assembler, 
interrupt  handling  routines,  and  device  controllers. 

2.  Level  II  -  Complex  Information  handling  Subroutines 
Level   II   routines   combine   the   facilities  of  the 

operating  system  with  the  hardware  oriented  routines  of  Lev- 
el I  to  provide  the  programs  and  user  oriented  languages 
to  oe  used  at  Level  III.  Examoles  are  file  management, 
buffer  management  utilities,  and  utilities  that  convert  user 
defined  coordinate  systems  to  a  device  dependent  coordinate 
system. 

3.  Level  III  -  Generalized  User  Oriented  Subroutines 
Level   III   routines   have   the   ability   to  perform 

several  Level  II  routines  to  accomolish  a  single  task.  The 
routines  allow  specification  of  disolav  functions  through 
device  indeoendent  oarameters.  They  are  called  within  a 
procedural  language  like  C  CI],  Algol  or  Fortran.  There- 
fore, they  add  to  the  caDabilities  of  an  existing  implemen- 
tation. Examoles  are  plot  routines,  automatic  scaling, 
print  and  label  routines. 

4.  Level  IV  -  Acplication  Lanquage  Processors 

Level  IV  programming  supoort  is  directed  at  the  user 
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who  is  not  a  programmer.  It  is  intended  to  make  him  less 
dependent  on  programming  by  simplifying  the  task  of  specify- 
ing graphic  output.  Once  imolemented  by  using  routines  in 
Levels  I#  II  and  III*  and  other  programming  techniques,  user 
languages  provide  access  to  the  graphic  device  and  increase 
its  usefulness.  Examoles  of  some  Level  IV  use r-or i en t edj 
high  level  language  systems  are  MIT  Sketch  Pad  [4],  Bell 
Animation  Language  [5,6]  and  G M  Design  Analysis  System  [7], 


VIII.   USER  INTERFACE  OESIGN  FOR  THE  RAMTEK  GX-100A 


A.   GENERAL 

In  the  design  of  a  user  interface  for  a  color  graphics 
device  a  primary  consideration  is  to  make  the  use  of  color 
as  easy  for  the  user  as  oossible.  The  user  should  be  per- 
mitted to  make  uo  colors  at  the  device  and  be  given  a  simple 
method  of  selecting  the  colors  desired  in  the  application 
program.  The  user  should  be  allowed  to  modify  the  colors  at 
will  either  during  proaram  execution  or  by  a  p re-execu t i on 
selection  process.  The  user  should  be  relieved  of  select- 
ing the  exact  bit  patterns  needed  to  produce  the  color  on 
the  screen.  Elimination  of  device  dependent  programming 
allows  the  user  to  think  of  color  as  it  applies  to  a  orob- 
1  em . 

It  is  necessary  to  isolate  the  user  from  the  low-level 
assembly  languages  to  allow  concentration  on  the  problem  and 
not  have  to  worry  about  when  and  how  to  issue  the  proper 
hardware  instructions  to  the  display  device.   A  user   should 
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be  able  to  think  in  terms  of  a  virtual  screen  space  of  his 
own  definition  and  not  be  concerned  -with  hardware  address- 
i  ng. 

When  a  user  interface  is  designed,  it  should  be  easily 
integrable  with  the  host  computer  language.  The  easiest  way 
to  accomplish  this  is  to  use  subroutine  calls  from  the  user 
program.  The  calls  should  be  keot  as  simple  to  use  as  prac- 
ticable. Toward  this  end/  the  number  of  parameters  involved 
should  be  kept  to  a  minimum. 

The  user  should  be  protected  from  abnormal  termination 
as  much  as  possible  by  the  interface.  As  an  example,  the 
interfacing  routines  can  check  the  passed  parameters  to 
ensure  that  they  are  correct.  They  should  indicate  errors 
and  what  they  are  to  simolifv  debugqing.  Graphic  tools 
provided  to  the  user  should  encourage  concise,  clear  pro- 
gramm  i  ng . 

The  overall  principles  and  methods  of  level  design  as 
discussed  earlier  were  followed  in  implementing  the  inter- 
face for  the  RAMTEK.  Since  Level  I  routines  were  essential- 
ly complete  or  were  hardware  implemented,  the  resulting 
design  took  place  more  in  the  Level  II  and  Level  III  areas. 
It  was  decided  to  implement  the  interface  as  a  set  of 
subroutine  calls  from  the  C  C1J  programming  language  because 
C  is  the  primary  language  on  the  host  computer  and  because 
of  its  simple  subroutine  calling  format. 

As  a  first  step,  a  set  of  primitives  were  designee  to 
form  the  basis  for  other  routines  to  build  on. 
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1.   Primitive  Functions 

The  primitive  functions  make  up  the  majority  of  the 
level  II  and  level  III  routines.  The  criteria  followed  in 
choosing  the  primitive  functions  were  clarity*  convenience/ 
and  compactness.  Clarity  means  primitives  are  to  perform 
only  one  function  and  that  function  must  be  clear  and  sim- 
ple. 

Due  to  the  hardware  caoabilites  of  the  RAMTEK, 
several  primitives  became  user  routines  on  Level  III  as  well 
as  being  primitives.  The  construction  of  a  set  of  primi- 
tives condensed  the  entire  capability  of  tne  RAMTEK  hardware 
functions  to  21  instructions  or  subroutines.  The  primitives 
which  are  applicable  to  user  programs  are  described  in 
Appendi  x  B . 


B.   APPLICATION  OF  COLOR 

After  the  design  of  the  primitive  set?  it  was  necessary 
to  design  a  method  by  which  the  user  would  be  able  to  easily 
utilize  and  understand  how  to  get  color  into  a  display  and 
control  or  modify  it.  Two  key  concepts  were  used.  The 
first  was  extended  from  an  actual  hardware  feature.  It  was 
the  video  lookup  table  concept  translated  into  a  color 
table.  The  available  colors  can  be  thought  of  as  a  book  of 
colors  from  which  the  user  can  choose  the  page  he  wishes  to 
use.  The  page  corresponds  to  the  color  table.  All  the  user 
needs  to  do  is  select  the  page  (color  table)  and  color 
(entry)  desired  and  then  draw  the  entities  using  that  color. 
The  concept  works  well*  but  a  problem  arose  as  to  how  to 
present   the  information  to  the  user  so  it  is  understandable 
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and  useable.  Humans  have  the  characteristic  of  not  all  per- 
ceiving the  same  color  the  same  way.  A  shade  of  blue  to  one 
person/  may  not  be  the  same  to  another.  And  of  course*  some 
humans  have  varying  degrees  of  color-blindness.  Also/ 
reoroduct ion  of  color  in  manuals  and  photographs  may  not  be 
accurate  representations  of  the  color  the  R A M T E K  displays  on 
its  CRT.  As  a  result  of  these  considerations/  it  was  decid- 
ed th'at  an  interactive  oroqram  should  be  designed  and  im- 
plementated  into  a  subroutine  call  to  allow  the  user  to 
examine  and  work  with  the  colors  while  actually  viewing  them 
on  the  RAMTEK  screen. 

1.   Interactive  Program 

The  interactive  subroutine's  purpose  is  to  allow  the 
user  to  see  and  modify  color  tables  while  seated  at  the 
RAMTEK  keyboard.   It  embodies  several  features. 

a.  Self-tutorial 

As  the  user  utilizes  the  routine/  instructions 
are  given  at  each  step  as  to  how  to  progress  through  the 
various  editing  modes. 

b.  Color  Table  Display 

The  page  representing  a  specific  color  table  is 
designed  so  the  user  sees  the  fifteen  colors  in  three  modes; 
a  solid  block  of  color/  a  line  of  color  and  alohanumeric 
characters  of  the  color  are  displayed.  The  display  thereby 
shows  the  different  appearance  color  can  take  on  when 
displayed  in  different  shapes. 

c.  Multiple  Edit  Modes 

The  routine  provides  five  methoas  of  editing  and 
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modifying  color  tables  and  their  entries.   This   gives   max- 
imum  flexibility  to  the  novice  as  well  as  the  more  advanced 
user.   The  use  of  the  interactive  routine   is   explained   in 
detail  in  Appendix  A. 
2 .   Color  Cube 

The  color  cube  transforms  the  video  lookup  table 
into  a  third  dimension  to  further  aid  in  communicating  to 
the  user  how  to  construct  colors  and-  how  they  relate  to  each 
other.  The  concept  of  the  color  cube*  as  illustrated  in 
figure  5,  describes  the  4096  colors  that  can  be  created  by 
defining  the  colors  as  ordered  triples  as  follows:  (0/0,0) 
to  (0,0,15)  represent  shades  of  red,  (0,0,0)  to  (0,15,0) 
represent  shades  of  green  and  (0,0,0)  to  (15,0,0)  represent 
shades  of  blue.  By  a  careful  inverting  and  combining  of  the 
three  axis,  many  of  the  4096  colors  can  be  created. 


C.   VIRTUAL  DISPLAY  SCREEN 

One  of  the  important  considerations  of  a  successful  user 
interface  was  met  by  writing  a  routine  to  allow  the  user  to 
define  the  address  soace  of  the  screen.  The  user  defines 
the  virtual  screen  bv  giving  floating  Doint  cartesian  coor- 
dinates representing  the  lower  left  and  upper  right  corners 
of  the  screen.  The  interface  remembers  his  declaration  and, 
until  the  user  changes  the  virtual  screen,  all  addresses  are 
transformed  from  the  virtual  coordinates  given  into  real 
screen  coordinates.  The  process  is  completely  transparent 
to  the  user.  To  further  aid  the  viewer,  an  axis  system, 
centered  where  desired,  can  be  disolayed  on  the  screen. 

If  the  user  chooses  not  to  declare  a  virtual  screen,  the 
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interface  defaults  to  an  100  by  100  unit  screen.   This   iso- 
lates the  user  from   real  screen  address inq  problems. 

All  virtual  screen  displacements  are  also  scaled  into 
real  screen  displacements,  thereby  giving  the  user  total 
freedom  to  define  the  virtual  screen  as  long  as  a  standard 
cartesian  coordinate  system  is  used. 

D.  HIGH  LEVEL  GRAPHIC  TOOLS 

A  set  of  level  III  graphic  tools  was  also  designed/  and 
its  use  and  descriotion  is  detailed  in  Appendix  A.  Here 
simplicity*  usablity  and  unde r s t andab 1 i t y  were  the  driving 
factors  in  the  design.  When  oossibl e»  the  user  never  has  to 
pass  more  than  four  parameters.  The  higher  level  tools  are 
logical  operations  that  require  the  programmer  to  remember 
as  little  as  possible  when  utilized. 

All  high  level  tools  which  draw  graphics  figures  scissor 
[83  the  image  by  permitting  only  the  portion  of  the  image 
that  falls  in  the  virtual  screen  to  be  displayed. 

All  routines  return  an  indication  if  an  error  has  oc- 
cured  or  an  incorrect  parameter  has  been  passed;  thereby 
providing  a  debugging  capability  to  the  user. 

E.  INPUT  AND  OUTPUT  ROUTINES 

Three  subroutine  calls  were  develooed  to  provide  the 
user  with  an  interactive  inout/output  capability.  The  first 
is  used  by  the  user  to  retrieve  single  ASCII  character  codes 
from  the  R A M T E K  keyboara.  The  second  is  used  by  the  user  to 
return  an  octal  or  decimal  number  from  the  RAMTEK  keyboard. 
The  third  is  used  to  return  a  floating  point  number   to   the 
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user   from   the   RAMTEK   keyboard.   These  routines  provide  a 
powerful  tool  to  the  user  in   programming. 

F.   MAINTAINABILITY 

The  functional  design  and  level  structuring  serve  to 
make  servicing  the  interface  an  easy  task.  When  a  specific 
function  does  not  perform  as  expected*  the  portion  of  the 
interface  which  applies  to  that  function  is  easy  to  find  and 
isolate  for  testing  and  debugginq.  M0st  of  the  interface 
routines  do  error  checking  and  se 1  f -document  a t i on  when  an 
error  occurs. 


IX.   RECOMMENDATIONS 


A.   USER  INTERFACE  ADDITIONS 

The  following  modifications  to  the  user  interface  are 
recommended.  The  design  and  implementation  of  a  complement- 
ing data  structure  to  hold  and  control  display  entities  for 
transfer  to  and  from  the  RAMTEK  on  user  command  would  be  an 
excellent  and  oowerful  addition  to  the  present  interface. 
The  data  structure  could  utilize  the  existing  routines  with 
few  changes.  Such  an  addition  would  aid  the  user  by  allow- 
ing selective  display  and  erasure  of  user  entities  with  a 
s  i  ng 1 e  command . 

A  1  s  o  >  further  interfacing  of  the  RAMTEK  keyboard  to  pro- 
vide cursor  control  and  readback  of  virtual  or  real  screen 
coordinates  from  its  location  would  be  extremely  useful. 
Several  of  the  unused  keys  could  be  turned  into  function- 
type  switches  as  well. 
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B.   ADDITION  OF  HIGH  LEVEL  USER  ROUTINES 

More  routines  to  give  the  PAMTEK  a  dynamic  graohics 
capability  is  oossible?  but  limited  by  the  raster  rate  and 
data  transfer  rate.  Move  routines  and  selective  erasure  of 
entities  can  be  accomplished  within  the  confines  of  a  well 
defined  data  structure. 


X.   CONCLUSIONS 

The  user  interface  as  desianed  and  implemented  is  work- 
ing with  no  known  software  buas.  The  entire  range  of 
hardware  capabilities  of  the  RAMTEK  have  been  successfully 
incorporated  and  tested.  Several  successful  high  level 
routines?  most  notably  the  plotting  routines?  demonstrate  a 
high  degree  of  usefulness  and  are  indicative  of  the  capabil- 
ities that  a  color  device  in  conjuct ion  with  an  adequate 
software  interface  has  to  offer. 
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APPENDIX  A:   USER  MANUAL 
I.   INTRODUCTION 

The  RAMTEK  GX-100A  is  a  color,  raster  scan  display  dev- 
ice, the  heart  of  which  is  a  color  cathode  ray  tube  not 
unlike  a  home  color  television  set.  In  fact,  its  raster 
scan  method  for  generating  a  picture  is  identical  to  commer- 
cial cathode  ray  tubes.  At  this  point  the  similarity  ends. 
Instead  of  decoding  signals  transmitted  by  a  television 
broadcast  station,  the  RAMTEK  gets  the  information  for  its 
picture  from  a  soecial  video  generator  which  reads  the  con- 
tents of  a  M  0  S  refresh  memory  which  contains  all  the  infor- 
mation needed  to  oroduce  an  image  on  the  screen.  It  is  not 
within  the  scope  of  this  manual  to  go  into  the  details  of 
how  the  electronics  functions,  but  to  inform  the  user*  on  how 
to  use  the  device  to  aisDlay  the  desired  image. 

A  brief  descriotion  of  the  parts  of  the  RAMTEK  will  be 
given  followed  by  a  discussion  of  its  various  aisplay  mooes. 
Next  a  discussion  of  how  the  user  can  define  and  utilize 
colors  will  be  presented. 

The  user  is  also  directed  to  AoDendix  B  for  information 
on  how  the  user  routines  implemented  in  the  interface  are 
used  and  what  their  functions  are.  Periodically  small  se- 
quences of  C  code  will  be  listed.  These  bits  of  code  are 
not  intended  to  run  without  the  necessary  C  and  user  inter- 
face routines  that  must  precede  them.  They  are  oresented  to 
demonstrate  how  certain  instructions  are  utilized. 
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II.   THE  RAMTEK  DISPLAY  SYSTEM 

A  more  detailed  discussion  of  the  functioning  of  the 
RAMTEK  can  be  found  in  the  RAMTEK  GX-100A  [9]  and  RAMTEK 
GX-1008  i2)     programmers  manuals. 

A.   GENERAL 

The  RAMTEK  consists  of  a  software  interface  to  the  user, 
a  display  generator,  keyboard,  video  lookup  table  and  a 
cathode  ray  tube.  Their  relationship  is  illustrated  in  fig- 
ure A-l  . 
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User  Interface,  RAMTEK  Relationship 
Figure  A-l 

The  user  program  executes  on  the  PDP-11/50.  When  the 
appropriate  instruction  is  executed,  the  interface  between 
the  program  and  the  display  generator  for  the  RAMTEK  is 
activated.   Information  can  be  sent  via  the  interface  to  the 
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display  generator  from  the  user  program  or  the  keyboard. 
Information  can  also  be  sent  from  the  keyboard  via  the  in- 
terface to  the  user  program.  After  the  display  generator 
interprets  its  instructions  and  constructs  the  display  in 
its  ROM  memory,  the  image  is  generated  on  the  CRT  according 
to  the  colors  contained  in  the  video  lookuD  table.  Any 
image  will  remain,  unless  over-written,  for  an  indefinite 
period  of  time  in  the  ROM  memory. 

The  keyboard  is  interfaced  to  the  user  program  and  to 
the  instruction  display  generator.  Information  can  be 
passed  from  the  keyboard  in  the  form  of  ASCII  character 
codes  to  the  user  program  or  to  the  disolay  generator  and 
finally  to  the  CRT  screen.  The  keyboard  also  contains  eight 
function  switches  to  control  the  action  of  a  cursor  which  is 
displayed  on  the  screen.  The  address  of  the  cursor  on  the 
screen  is  always  available  to  the  user  orogram  via  the  in- 
terface. 

The  video  lookuo  table  contains  the  coded  information 
which  is  used  in  generating  color.  The  table  is  available 
via  the  interface  to  the  user  program.  By  modifying  the 
contents  of  the  table,  various  colors  can  be  displayed  on 
the  sc  reen . 

The  RAMTEK  graDhics  disolay  in  the  Naval  Postgraduate 
School  Comouter  Laboratory  utilizes  a  raster  scan  cathode 
ray  tube  with  a  screen  resolution  of  240  horizontal  lines 
and  640  elements  on  each  line.  A  specific  element  and  line 
is  referred  to  as  a  oixel.  This  device  has  a  high  element 
resolution   and   a   low   line   resolution.    Therefore,   the 
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quality  of  some  images  on  the  RAMJEK  can  be  rather  poor. 
Lines  that  are  not  horizontal  or  vertical  are  drawn  with  a 
noncontiguous,  staircase  effect.  When  utilizing  the  device 
these  resolution  factors  should  be  kept  in  mind  especially 
when  operating  in  a  data  mode.  Addressing  the  CRT  screen  is 
discussed  in  the  section  on  Virtual  Screen  Addressing. 

Color  is  generatea  by  mixing  three  primary  colors;  blue, 
green  and  red  in  varyinq  intensities.  Using  color  is  dis- 
cussed in  a  later  section. 


B.   VIRTUAL  SCREEN  ADDRESSING 

The  initialization  of  the  RAMTEK,  which  is  accomplished 
by  the  instruction  ramtekO,  presets  the  virtual  screen  to  a 
standard  cartesian  coordinate  address  SDace  with  (0.0,0.0) 
as  the  lower  left  corner  of  the  screen  and  (100.0,100.0)  as 
the  upoer  riqht  corner.  The  virtual  screen  can  be  redefined 
by  issuing  a  sc reen ( x , y ,  x 1 , y 1 )  instruction. 

screenO  redefines  the  virtual  screen  by  setting  trie 
lower  left  corner  to  (x,v)  and  the  uoper  right  corner  to 
(xl/vl).  The  only  restrictions  are  that  the  two  points 
define  a  valid  cartesian  coordinate  system  and  the  four 
values  are  floating  point  numbers.  All  addresses  and  dis- 
placements issued  subsequent  to  a  screenO  instruction  are 
interpreted  according  to  the  defined  virtual  screen. 

The  virtual  screen  is  addressed  by  specifinq  an  x,y 
coordinate  with  a  strtxv(x,y)  instruction.  The  specified 
address  (x,y)  establishes  the  current  operating  point  (COP) 
at  that  address.  The  COP  is  initially  located  at  the  lower 
left  corner  of  the   virtual   screen   whenever   a   screen   is 
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defined.  The  COP  is  occasionally  modified  after  certain 
operations  are  performed  as  indicated  in  Aopendix  B  and  in 
the  section  on  display  modes. 

There  are    three  modes  of  addressing   the   screen?   abso- 
lute; indexed  and  relative. 

1.  Absolute  Addressinq 

In  absolute  addressing  the  user  specifies  a  soecific 
location  on  the  user-defined  screen  by  issuing  a 
strtxyCx/y).  The  'x'  and  'y1  values  establish  the  location 
of  the  COP. 

2.  Indexed  Addressing 

To  utilize  indexed  address  i  n  g  /  the  user  must  issue 
an  inoex(i/X/y)  instruction.  If  'i'  is  equal  to  one,  indexed 
addressing  is  initiated.  Subsequent  to  this  instruction/ 
all  addresses  specified  by  the  user  are  interoreted  accord- 
ing to  the  values  ' x '  and  ' y '  contained  in  the  last  indexC) 
instruction.  For  example/  if  a  s t r t x y (  1  0  .  0  /  1  0  .  0  )  is  issued 
after  an  i ndex ( 1 / 1 5 . 0 / 20 . 0 )  has  been  issued/  the  resulting 
COP  is  (25.0/30.0) . 

To  deselect  indexed  addressing  it  is  necessary  to 
issue  an  indexC)  instruction  with  '  i  '  equal  to  zero.  The  x 
and  y  values/  if  any,  are  ignored  and  the  user  is  returned 
to  the  absolute  addressing  mode. 

3.  Relative  Addressinq 

The  hardware  relative  addressing  is  implemented  by  a 
single  instruction.  The  issuing  of  a  pointr(x/y)  instruc- 
tion utilizes  relative  addressing.  to  hen  issued/  the  COP  is 
calculated  by  taking  the  old  COP  x  and  y  values  and   summing 
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them  with  the  pointrO  x  and  y  values.  For  example/  if  the 
old  COP  is  (22.0,50.0),  and  a  po i n t r ( 30 . 0 , -  1 0 . 0 )  is  issued, 
the  new  COP  becomes  (52.0,40.0).  Relative  addressing  is 
only  utilized  when  a  oointrO  instruction  is  issued  and 
always  refers  to  the  last  COP. 


III.   CONTROL  MODES  AMD  CONTROL  FLAGS 

The  RAMTEK  operates  in  any  one  of  eight  modes.  Each 
mode  has  associated  with  it  certain  control  flags  which 
modify  its  operation  in  the  mode  selected.  Table  A-I  sum- 
marizes the  control  modes  and  control  flags  and  their  rela- 
tionship. 

Control  modes  are  set  by  issuing  a  setmode(a,b)  instruc- 
tion. The  value  of  'a'  indicates  the  mode  the  RAMTEK  is  to 
be  placed  in.  The  value  of  'b'  tells  the  interface  whether 
to  save  the  control  flags  of  the  previous  mode  or  not.  The 
values  of  'a'  and  'b'  that  may  legally  be  assigned  are  sum- 
marized in  Aopendix  B.   The  control  modes  are    as  follows: 

A.   ALPHANUMERIC  DATA  MODE 

Alohanumeric  Mode  is  the  default  mode  upon  initializa- 
tion of  the  RAMTEK.  All  dataO  instructions  issued  while  in 
this  mode  are  interpreted  as  passing  alphanumeric  data.  The 
data  is  processed  leftmost  byte  first  and  is  interpreted  as 
eight  bit  extended  ASCII  character  codes.  Each  received 
character  code  is  transformed  into  a  dot  matrix  character 
font  which  is  five  real  screen  elements  by  seven  real  screen 
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lines  in  dimension.  The  character  font  is  within  a  seven 
element  by  twelve  line  matrix  as  illustrated  in  figure  A -2. 
The  entire  character  set  is  illustrated  in  reference  C 2 ]  . 


\ 

NEW  COP 


RAMTEK  Character  Font 
F  i  gu  re  A-2 
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TABLE  A-I 


CONTROL  MODES  AND  CONTROL  FLAGS 


Definitions: 


IX  - 

BK  - 

AW  - 

DW  - 

FP  - 

YES  - 

NO  - 


Indexed  Addressing 

Reverse  Background 

Add  i  t  i  ve  Write 

Doubl e  Width 

Fixed  Point 

Indicates   the   Control  Flag  has 

effect  in  the  Control  Mode 

Indicates   the  Control  Flag  does 

not  have  effect  in   the   Control 

Mode 


No. 


Mode 
Name 


Control  Flags 
IX    BK    AW    DW    FP 


0  A  1 phanumer  i c 

1  T  ransve  rse  Data 

2  Raster  Data 

3  Comp lex  Data 

4  Grpah  i  c  Vector 

5  Graphic  Plot 

6  Graphic  Cartesian 

7  Graph  i  c  El ement 


YES  YES  YES  YES  NO 

YES  YES  YES  YES  NO 

YES  YES  YES  YES  NO 

YES  YES  NO  YES  NO 

YES  YES  NO  NO  YES 

YES  YES  NO  YES  YES 

YES  YES  NO  NO  YES 

YES  YES  NO  YES  NO 
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The  transmitted  ASCII  characters  are  displayed  starting 
at  the  COP  from  left  to  right  on  the  same  line  as  illustrat- 
ed in  figure  A-2.  If  more  than  91  characters  are  written  on 
one  line*  they  will  "wrap  around"  and  overwrite  on  the  same 
line.  No  more  than  twenty  character  lines  can  be  displayed 
on  the  sc  reen . 

Completion  of  execution  of  a  data()  instruction  causes  a 
"line  feed"  and  "carriage  return".  Each  subseauent  dataO 
instruction  will  disDlay  on  the  next  alphanumeric  line  at 
the  same  starting  element  as  illustrated  in  figure  A-2.  The 
new  COP  after  each  execution  is  also  illustrated  in  figure 
A-2. 

When  the  characters  are  drawn  on  the  R A M T E K  screen,  the 
character  appears  in  the  designated  color  while  the  rest  of 
the  matrix  is  drawn  in  the  background  color. 

1.   Applicable  Control  Flaos  , 

a.  Indexed  Addressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Background  Flag 

If  set,  the  character  is  displayed  in  the  back- 
ground color  and  the  rest  of  the  matrix  in  the  selected 
color  as  illustrated  by  the  'Y'  in  figure  A-2. 

c.  Additive  Write  Flag 

If  set,  the  character  is  written  over  whatever 
image  happens  to  be  at  the  same  location  on  the  screen.  The 
use  of  the  additive  write  flag  is  convenient  for  combining 
characters   to   create    special    characters    or    writing 
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characters  close  to  other  images  to  avoid  destroying  a  por- 
tion of  the  existing  image  when  the  seven  by  twelve  matrix 
is  written.  The  second  apol  icat  ion  is  illustrated  in  figure 
A-3. 

d.   Double  Width  Flag 

If  set,  causes  the  displayed   characters   to   be 
twice   as   wide  as  normal  as  illustrated  in  figure  A-4.   The 
use  of  double  width  characters  decreases  the  maximum   number 
of  characters  oer  line  to  4 5 • 
2,       Other  Instructions 

See  also  stroutO  and  IttrC)  on  Aooendix  B  for  addi- 
tional alphanumeric  generating  capability. 


Effect  of  Additive  Write  Flag  in  Alohanumeric  Mode 

Figure  A-3 
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DOUBLE     WIDTH 


Effect  of  Double  Width  Flag  in  Alphanumeric  Mode 

F  i  gure  A-U 

8.   TRANSVERSE  DATA  *0DE 

All  data()  instructions  issued  in  transverse  data  mode 
are  interpreted  as  passing  transverse  data.  Received  data 
is  written  in  its  raw  format,  that  is,  each  data  byte  (pro- 
cessed leftmost  first)  is  interoreted  as  a  single  bit  per 
Dixel  description  of  eight  consecutive  pixels  along  a  par- 
ticular real  screen  line.  As  illustrated  in  figure  A-5/ 
consecutive  data  bytes  are  written  from  left  to  right  begin- 
ning at. the  COP  and  continuing  down.  All  subsequent  bytes 
are  written  beginning  at  the  same  element  on  the  next  line. 
The  COP  after  the  operation  is  indicated  in  figure  A-5. 

The  typical  use  of  transverse  data  is  to  define  special 
symbols  and  characters  which  can  not  be  found  in  the  stan- 
dard character  set. 
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Data:  015022 
133000 
000101 


OLD  COP 


"i 


NEW  COP 


} 


0001  101 

10110110 

00000000 


00 


0010010 
00000000 
01000001 


aA 

■ 

Transverse  Data  Processing 
Figure  A-5 

1.   Apolicable  Control  Flags 

a.  Indexed  Redressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Backgrouna  Flag 

If  setf  the  data  is  disolayed  as  indicated  in 
figure  A-6.  In  effect  ^  the  comolement  of  the  data  is 
di  sp 1 aved . 

c.  Double  Width  Flag 

If  set/  each  bit  is  reflected  in  two  consecutive 
pixels  instead  of  one,  thereby  giving  an  image  sixteen  oix- 
els  wide  instead  of  eight.  The  result  is  illustrated  in 
f  i  gu  re  A-6 . 


43 


d.   Additive  write  Flag 

If  set,  the  transmitted  data  is  written  over 
whatever  image  hapoens  to  be  at  the  same  location  on  the 
sc  reen . 


Data:  015022 
133000 
000101 


0001  1010 
10110110 
00000000 


00010010 
00000000 
01000001 


— i^—       —  _—  -mi  mm»  mm ■  — —  — —  I 

i— ■  H i L 1 1 I I I I — I — B 


NEW 
COP 


Effect  of  Reverse  Background  and 
Double  rtidth  Flags  on  Transverse  Data 

Figure  A-6 


C.   RASTER  DATA  MODE 

Raster  data  mode/  except  for  the  direction  of  the  writ- 
ing process^  is  identical  to  the  transverse  data  mode.  As 
illustrated  in  figure  A-7,  the  consecutive  bvtes  transmitted 
by  the  d  a  t  a ( )  instruction  are  written  horizontally  from  left 
to  right  beginning  at  the  COP.  All  subsequent  bytes  are 
written   beginning   at  the  next  pixel  on  the  same  line.   The 
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COP  after  Che  ooeration  is  as  illustrated  in  figure  A - 7 . 
The  control  flags  that  apoly  to  transverse  data  mode  also 
apply  to  raster  data  mode  in  the  same  manner. 


Data:   013232 
127076 


000101  10 
1010111 


NEW  COP 


10011010 
01  1  1  1  10 


Raster  Data  Processing 
Figure  A -7 


D.   COMPLEX  DATA  MODE 

This  mode  is  used  to  write  data  on  the  screen  exactly 
the  same,  way  that  raster  data  does.  However/  a  third  dimen- 
sion is  added  in  this  mode  in  that  each  pixel  is  described 
by  four  bits  of  the  passed  data.  Therefore*  a  single  data 
word  describes  four  oixels  instead  of  two  as  in  the  previous 
data  modes . 

The  benefit  of  this  mode  is  that  the  color  of  each  pixel 
being  passed  is  defined  by  the  four  bits  that  are  assigned 
to  that  pixel.  The  four  bits  reoresent  a  number  from  zero 
through  fifteen  which  is  used  as  a  do  inter  into  the  color 
lookup  table.  If  the  pointer's  value  is  six  (0110),  the 
color  of  the  oixel  will  be  whatever  is  indicated  in  entry 
six  of  the  color  table  in  use. 

It  can  be  seen  that  this  mode  overrides  the  color  desig- 
nated by  the  colorO  instruction.  Interesting  images  can  be 
achievea  Dy  the  use  of  this  data  mode.   All  flags  applicable 
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to  raster  data  are  applicable  to  Comdex  data  except  addi- 
tive write.  Fiqure  A  - 8  illustrates  now  a  data  word  is  in- 
terpreted in  this  mode. 


DATA  WORD: 


1 

1 

1 

1 

1 

o 

1 

0 

0 

r 
1 

1 

i 

0 

0 

1 

1 

= 175163 


^MxMxMXH 


OLD  COP 


NEW  COP 


Complex  Data  Processing 
Figure  A-8 


E.   GRAPHIC  VECTOR  MODE 

The  graohic  vector  mode  draws  lines  between  arbitrary 
end  points.  The  starting  point  is  defined  by  the  existing 
COP  or  can  be  defined  by  issuing  a  strtxyC)  to  establish  the 
new  COP.  The  end  point  can  be  defined  by  issuing  either  a 
pointrO  instruction  or  a  oointO  instruction.  The  first 
uses  relative  aoaressing  and  the  second  uses  absolute  or 
indexed  dependinq  upon  the  control  flags'  condition. 

After  execution  of  an  instruction/  the  COP  is  then  the 
end  point  of  the  vector  just   drawn.    Therefore/   a   linked 
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line/  as  illustrated  in  figure  A  - 9 ,  can  be  drawn  by  issuing 
a  strtxyC)  followed  by  successive  ooint  ()  or  pointrO  in- 
structions. 


Instructions: 


setmodeCU, 0) ; 
strtxyUO. 0,10.0); 

poi  nt (5.0/ 8  .0  )  ; 
point  C 12.0,9.0)  ; 
poi  nt  r(-l  .0/2.0)  ; 


(io.o.io.o) 


(5.0.8.0) 


(11.0.11.0) 


(12.0,9.0) 


Drawing  Vectors  in  Graphic  Vector  Mode 
F  i  gu  re  A -9 

1.   Apolicable  Control  Flags 

a.  Indexed  Addressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Background  Flag 

If  set/  the  lines  are  drawn  in  the  background 
color. 

c  .   Fi  xpo  i  nt  F 1 ag 

If  set/  causes  the  Doint  issued  by  a  strtxyC)  to 
be  the  starting  ooint  for  all  subsequent  end  coints  issued. 
Therefore/  the  lines  are  drawn  with  a  common  point  as  illus- 
trated in  figure  A-10. 
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Inst  rue  t  i  ons  : 


setmode(4, 0) ; 

Hxptci) ; 

strtxy(5. 0,5.0), ' 
poi  nt (8.0,  7.  0  )  ; 
dot  nt (6.0,5.  0  )  ; 
poi  nt  r(-l .0, -1  .0)  ; 

(8.O.7.0) 


(S.O.5.0)  yS    (6.0.5.0) 

(4.0,4.0) 

Orawjng  Vectors  with  Fixooint  Flag 

F  i  gure  A  -  1  0 
F*   GRAPHIC  PLOT  MODE 

The  functions  performed  by  the  graphic  olot  mode  have 
been  implemented  as  a  set  of  olot  routines  in  the  user  in- 
terface. The  three  routines  are  olotctO,  plotln()  '  and 
plothO  . 

The  first  olots  a  function  as  a  series  of  points.  The 
second  olots  a  function  as  a  continuous  line  and  the  third 
plots  a  function  in  a  histogram  style  olot.  Each  of  the 
methods  reguires  the  user  to  soecify  the  ooints  to  be  clot- 
ted. The  three  plotting  methods  are  illustrated  in  figure 
A-ll.  Detailed  instructions  on  their  use  can  be  found  in 
Appendix  B.  It  is  recommended  that  these  routines  be  used 
in  lieu  of  the  graohic  olot  mode  as  they  are  simpler  to  use 
and  orovide  a  more  powerful  caoability.  However,  for  the 
programmer  who  is  interested  in  using  the  assembly  language 
level  instructions  necessary  in  this  mode,  he  is  referred  to 
reference  12)   . 
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plotptO 


plotln(  ) 


p(oth(  ) 

Plotting  Met  hods 
F i  gure  A- 1  1 


G.   GRAPHIC  CARTESIAN  MODE 

The  graphic  cartesian  mode  draws  solid  rectangles 
between  arbitrary  endpoints.  The  endDoints  define  opcosi  Ce 
corners  of  a  rectangle.  The  COP  is  always  the  starting 
point  of  the  drawing  unless  a  new  COP  is  defined  with  a 
strtxyC)  instruction.  The  second  ooint  can  be  issued  with  a 
ooint ()  or  ooint r()  instruction.  After  the  ooeration  is 
oerformed/  the  new  COP  is  the  second  point  that  was  issued. 

By  issuing  successive  ooints>  linked  rectangles  can  ce 
drawn  as  illustrated  in  figure  A  -  1  2  .  In  this  case/  the  end- 
ing ooint  for  one  rectangle  becomes  the  starting  point  for 
the  next. 

U9 


1.   Apolicable  Control  Flags 

a.  Indexed  Addressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Background  Flag 

If  set/  the  rectangles  are  drawn  in  the  back- 
ground color. 

c .  Fixed  Point  Flag 

If  set ,  all  rectangles  are  drawn  with  a  common 
starting  point  much  in  the  same  way  it  is  done  in  the  graph- 
ic vector  mode.  A  strtxyC)  instruction  determines  the  com- 
mon point/  and  subsequent  point ()■  or  pointr()  instructions 
determine  the  rectangles  as  illustrated  in  figure  A  -  1  2  . 


Instruct  ions: 


setmode(6,0); 
strtxyClO. 0/6.0); 
point (12.0,8.0) ; 

point  (  13.0/9.0)  ; 
f  i  x  d  t  C  1  )  ; 
strtxy(5. 0/8.0)  ; 
poi  nt  (6  .  0/6.0); 
ooi  nt (U.0/ 7  .  0 ) ; 


//  draws  A. 
//  draws  8 . 


/ /  draws  C . 
//  draws  0 . 


^(6.0.6.0) 


(13.0.9.0) 


'(12.0.8.0) 


V(io. 0,6.0) 


Drawing  Rectangles  With  and 
Without  Fixpoint  Flag 


F  i  gu  re  A- 1 2 
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H.   GRAPHIC  ELEMENT  MODE 

The  graphic  element  mode  draws  a  single  pixel  on  the 
screen  as  determined  by  a  ooint()  instruction  or  a  pointrC) 
instruction.  After  execution,  the  COP  is  on  the  same  real 
screen  line  and  one  screen  element  to  the  right. 

1.   Applicable  Control  Flags 

a.  Indexed  Addressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Background  Flag 

If  set/  the  pixels  are  drawn  in   the   backaround 
color. 

c.  Double  Wiath  Flag. 

If   set,  two  Consecutive  pixels  on  the  same  line 
are    drawn  instead  of  one. 


IV.   USING  COLOR 

As  mentioned  earlier/  all  images  that  are  displayed  on 
the  screen  are  displayed  according  to  an  entry  in  the  video 
lookup  table  which  can  also  be  referred  to  as  the  color 
lookup  table.  This  section  will  discuss  how  to  define 
colors  the  user  desires/  load  the  color  lookup  table/  use 
the  special  interactive  routine  to  build  color  tables  and 
use  the  color  lookup  table  in  user  programs. 

A.   DEFINING  COLORS 

The  RAMTEK  hardware  defines   colors   by   combining   red/ 
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green  and  blue  in  varying  intensities  to  produce  color. 
Since  the  color  lookup  table*  from  which  the  CRT  receives 
its  instructions  on  how  to  mix  the  three  colors*  stores 
information  in  digital  f  o  r  -n  a  t  *  the  user  is  limited  to  4096 
possible  color  definitions.  Since  the  table  has  a  finite 
length  of  sixteen  twelve  bit  entries  and  only  one  table  can 
be  used  at  any  one  time*  only  sixteen  colors  can  be 
displayed  at  any  one  time  on  the  screen.  It  must  also  be 
keot  in  mind  that  entry  zero  in  the  table  is  used  as  the 
background  color  that  is  to  be  displayed  on  the  screen 
thereby  leaving  fifteen  colors  for     image  drawing. 

In  order  to  define  an  entry  in  the  color  lookuo  table* 
it  is  first  important  to  examine  how  the  color  lookup  table 
stores  its  information. 

1.   The  Color  Lookup  Table 

There  are  sixteen  entries  in  the  color  lookup  table. 
Each  entry  reoresents  the  code  for  a  color  in  a  twelve  bit 
word.  As  illustrated  in  figure  A-13*  each  word  is  broken 
into  three*  four  bit  binary  numbers  which  represent  the 
intensities  of  blue*  green  and  red  to  be  mixed. 


bl 

ue 

green 

red 

11    10    987     654321      0 

Color  Lookup  Table  Entry  Format 
Figure  A - l 3 
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It  is  convenient  to  think  of  the  entry  in  each  table 
as  an  ordered  triple:  (0-15,0-15*0-15).  This  can  be  extend- 
ed into  a  three-dimensional  definition  of  the  color  space  in 
which  the  RAMTEK  is  capable  of  displaying  color.  Figure  5 
in  the  earlier  section  on  Application  of  Color  illustrates 
this  concept.  The  x  -  a  x  i  s  contains  the  sixteen  possible 
shades  of  blue?  the  y-axis  contains  the  sixteen  possible 
shades  of  green  and  the  z-axis  contains  the  sixteen  possible 
shades  of  red.  By  movina  within  the  confines  of  the  cube, 
all  4096  colors  are  aefined*  and  their  relationship  to  each 
other  is  illustrated. 

2.   Defining  Color  Table  Entries 

In  order  to  define  an  entry  in  the  color  lookup 
table*  it  is  necessary  to  transform  from  an  ordered  triple 
to  the  twelve  bit  coded  form.  This  is  accomplished  by  a 
special  routine  called  triple(b*g*r).  The  ordered  triple 
(b*g*r)  directlv  corresponds  to  the  color  cube  location 
representing  the  color  the  user  desires.  The  routine  re- 
turns the  properly  coded  entry  for  loading  into  a  color 
tabl e. 


B.   LOADING  THE  COLOR  LOOKUP  TABLE 

The  RAMTEK  interface  system  permits  the  use  of  eighteen 
separate  color  tables.  The  first  four  tables  (0-3)  are 
reserved  system  tables  and  cannot  be  modified  in  any  way. 
Some  of  the  other  tables  already  have  entries  in  them  for 
the  benefit  of  the  user  who  wishes  to  use  them*  and  others 
are    emot  y  . 

There  are    three  methods  of  loading  a  color  lookup  table 
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in  the  user's  program.  One*  the  interactive  color  routine 
will  be  discussed  separately.  The  other  two  are  discussed 
here.  The  first  is  a  method  for  loadinq  an  entire  color 
lookup  table/  and  the  second  is  for  loadinq  a  single  entry 
in  a  color  lookup  table. 

1.   Loading  an  Entire  Table 

To  load  a  whole  color  lookup  table  requires  a  series 
of  operations.  First*  the  user  needs  to  declare  a  sixteen 
word/  linear  integer  array.  Then  it  is  necessary  to  load 
each  entry  of  the  array  from  zero  to  fifteen  with  the  six- 
teen colors  that  are  desired.  In  order  to  accomplish  this* 
it  is  recommended  that  the  triplet)  routine  be  used  to  code 
the  ordered  triples  and  then  assign  the  returned  codes  to 
each  entry  in  the  array. 

After  the  array  has  been  loaded/  it  is  then  entered 
into  the  desired  color  lookup  table  by  the  routine 
C 1 r t b 1 ( n / name ) .  The  parameter  'n1  is  the  number  of  the 
color  lookup  table  C 4 - 1 7 )  and  'name'  is  the  name  of  the  user 
array  which  contains  the  sixteen  coded  entries  to  be  loaded. 

An  examole  of  the  code  to  load  a  color  table  is  as 
foil ows : 


int  allfel;    //declares  sixteen  word  array. 
atO]  =  t riol e(0/0/0)  ;     //  color  black. 
a[l]  =  triple(15/0,0);    //  color  blue. 
at21  =  t r i ol e(0/ 15/ 0) ;    //  color  green. 


a[151  =  triple(15/15/15);  //  color  white. 
clrtbl(5/a);      //loads  color  lookuo  table. 


54 


The  color  lookup  table  entries  contained  in   the   array   'a' 

are       loaded  into  color  lookup  table  number  five  and  are    then 

ready  for  use. 

2 .   Single  Entry  Loading 

It  may*  at  times*  be   desirable   to   load   only   one 

entry  in  a  given  color  lookup  table.   In  order  to  do  so*  the 

entry  is  coded  with  the  triple  routine  and  then  loaded  in   a 

specific  table  and  entry  by  using  the  chnge(numb*entry*cont) 

routine.   For  example*  to  load   the   color   defined   by   the 

ordered   triple   (5*6*10)   into   entry  three  of  color  lookup 

table  ten*  the  following  two  instructions  are  issued: 

cont  =  triole(5*6*10); 
chnge (10*3*  cont ) ; 

If  the  change  takes  place  in  a  color  lookup  table  that  is 
being  used  for  display*  the  change  is  reflected  on  the 
screen  immediately. 


C.   INTERACTIVE  COLOR  PROGRAM 

The  puroose  of  the  interactive  orogram  is  to  allow  the 
user  to  see  and  modify  color  lookup  tables  while  seated  at 
the  RAMTEK  keyboard.  It  is  recommended  that  the  new  user 
sit  down  at  the  RAMTEK  and  execute  interO  in  order  to  get 
an  introduction  to  the  color  generating  capabilitiesof  the 
RAMTEK.  There  are  two  basic  modes  in  which  the  routine 
operates.  Each  of  these  modes  has  a  series  of  commands 
which  the  user  can  execute.  Appendix  B  describes  the  com- 
mands for  each  mode  in  detail  in  its  description  of  inter(). 

1  .   Pag  i  ng  Mode 

The  paging  mode  oermits  the  user  to  page  through  the 
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eighteen  possible  color  lookup  tables.  Upon  execution  of 
interO  the  paging  mode  is  automatically  entered  and  a  set 
of  tutorial  instructions  are  displayed. 

2.   Edit  Mode 

The  routine  orovides  five  separate  methods  of  edit- 
ing and  modifying  color  lookup  tables  and  their  entries. 
How  to  use  the  methods  is  described  in  Appendix  B  in  the 
descriotion  of  interO  . 

a.  Table  Assignment 

Table  assignment  mode  allows  the  user  to 
copy  entries  from  any  table  into  a  designated  user  table. 

b.  Octal  Assignment 

Entries  in  a  desianated  user  table  can  be 
defined  by  entering  an  ordered  octal  triple  reoresenting  the 
color  des  i  red . 

c.  Combining  Assignment 

Entries  from  two  color  lookup  tables  can  be 
logically  OR'd  into  a  designated  user  table  or  two  whole 
tables  can  be  OR'd  into  the  user  table. 

d.  Inverting  Tables 

This  method  permits  the  user  to  invert  a 
designated  table.  Entry  zero  becomes  entry  fifteen,  entry 
one  becomes  entry  fourteen  and  so  on. 

e .  CoDy  i  nq  Tables 

This  method  permits  the  user  to  make  cooies 
of  any  table  in  the  system  into  a  selected  user  table. 
Thus/  the  user  can  modify  a  system  table  without  destroying 
i  t  . 
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D.   PROGRAMMING  WITH  COLOR 

Using  color  on  the  RAMTEK  is  not  a  difficult  process 
once  the  user  understands  color  lookup  tables  and  their 
entries.  As  mentioneo  earlier/  the  system  has  caoability  at 
present  of  storing  up  to  eighteen  color  lookuo  tables. 
Tables  zero  through  three  are  reserved  system  tables  leaving 
tables  four  through  seventeen  for  the  user.  The  system  has 
some  preloaded  tables  which  contain  a  variety  of  colors  that 
the  user  may  find  useful.  If  not/  they  can  be  destroyed  as 
des  i  red. 

It  is  a  good  practice  for  the  user  to  design  his  pro- 
grams making  use  of  the  interC)  routine.  By  placing  the 
interO  routine  inside  a  1  o  o  o  /  the  user  can  modify  the  table 
or  tables  the  program  uses*  run  the  program  and  return/  if 
desired/  to  the  interO  routine  to  chanae  entries  in  the 
color  lookup  tables  until  the  desired  colors  are  achieved. 
The  user  should  then  save  the  codes  for  future  use. 

Issuing  a  colort(n)  instruction  in  the  user  program 
causes  the  designated  color  lookup  table  to  be  loaded  into 
the  RAMTEK  hardware  video  lookup  table.  All  images  are  then 
displayed  relative  to  the  colors  contained  in  table  'n'.  In 
order  to  select  a  specific  color  to  be  used/  the  color(e) 
instruction  is  issued.  All  images  drawn  subseauent  to  this 
instruction  will  be  drawn  with  the  color  contained  in  entry 
'e'  of  the  color  lookup  table  last  selected. 

For   example/  suppose  color  table  five  was  the  table  the 

user  wished  to  use/  and  it  contained  the  following  entries: 

entry  zero   -  black  (0/0/0) 
entry   one   -  red   (0/0/15) 
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entry   two   -  blue  (15*0,0) 
entry  three  -  green  (0,15*0) 


The  following  instructions  would  display  a  red  rectangle,  a 
blue  line  and  a  green  letter  'A'  on  a  black  background. 
Entry  zero  always  contains  the  background  color. 


c  o  1  o  r  t  ( 5  )  ; 
c  o  1  o  r  (  1  )  ; 
//draw  red  rectangle, 
set  mode (6,0); 


//loads  color  table  five. 
//selects  entry  one  (red). 


//set  Graphic  Cartesian 
mode . 

strtxy (5.0,5.0) ; 

point ( 1 0.0, 10.0) ; 
//draw  blue  line. 

c  o  1  o  r  (  2  )  ;        //select  entry  two  (blue). 

set  mode ( 4 , 0 ) ;        //set  Graphic  Vector  mode. 

strtxy ( 15.0, 15.0) ; 

point (22.8, 10.5) ; 
//draw  green  letter  'A'. 

color(3)J        //select  entry  three  (green). 

set  mode ( 0 , 0 ) ;        //set  Alphanumeric  mode. 

s  t  r  t  x  y  (  5  0  . 0,25.0) ; 

data(letter,l);   //letter  is  an  array    containing 

//the  ASCII  code  for  an  'A'. 


If  at  any  time  a  new  color  table  is  entered,  all  exist- 
ing images  will  change  color  to  the  entries  that  are  in  the 
new  table.  ,  A  1  s  o  ,  if  at  any  time  an  entrv  in  the  table  being 
used  is  changed,  any  image  on  the  screen  that  was  drawn  with 
that  entry  number  will  change  to  t^e  new  color.  If  in  the 
preceding  example  the  next  instruction  loaded  a  table  which 
contained  the  color  white  in  entries  one  and  two,  and  blue 
in  three,  the  rectangle  and  line  would  become  white  and  the 
letter  'A'  would  become  blue. 
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V.   PROGRAMMING  THE  RAMTEK 

There  are  two  routines  which  it  is  necessary  to  olace  at 
the  beginning  of  any  C  program  which  desires  to  utilize  the 
user  interface  for  the  RAMTEK. 

The  ramtek()  routine  must  be  the  first  call  made  in  the 
user  program.  It  is  the  initialization  routine  for  the  user 
interface  and  it  opens  the  RAMTEK  device  and  keyboard. 

The  erase()  routine  should  follow  the  ramtekU  routine. 
This  ensures  that  any  old  images  on  the  screen  or  in  the 
RAMTEK  memory  will  be  removed. 

Appendix  B  contains  a  complete  list  of  the  user  routines 
which  will  relieve  the  user  of  a  significant  amount  of  pro- 
gramming effort  in  many  cases.  Most  user  routines  return 
negative  values  for  error  conditions  or  if  incorrect  parame- 
ters are  passed.  It  is  therefore  advisable  to  be  aware  of 
the  values  and  their  meanings  to  aid  in  debugging  programs. 

In  order  to  utilize  the  interface*  the  following  compile 
command  should  be  issued: 

cc  f  i  1 ename  -  1  r 

A.   RESERVED  WORDS 

Table  A-II  contains  a  list  of  reserve  words.  These 
words  should  not  be  used  for  user  names  in  any  programs  that 
utilize  the  user  interface  for  the  RAMTEK  device.  Some  of 
the  words  are  user  interface  routine  names  and  others  are 
variables  and  subroutine  names  in  the  interface  software. 
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TABLE  A-II 


RESERVED  WORDS 


ADOF 

adon 

ALPH 

axis 

BKON 

BKOF 

bk  rn 

b  1  an 

BLK 

b  1  oc 

brae 

buff 

byte 

c 

chnq 

Cl  Ph 

c  1  rt 

code 

code 

coke 

col  o 

co  1  o 

co  1  o 

c  omb 

COMM 

COMP 

conv 

conv 

CODy 

CR 

data 

data 

dbl  w 

di  so 

dumo 

e  i  ns 

eoaq 

eoag 

epaa 

eras 

ERS 

f  i  xo 

flio 

f  nam 

fp 


F 
d 

k 

k 
ket 

cnt 

e 

old 

ol 

i  t 

r 

rt 
rtbl 

A 
D 

e 
1 


o 

id 


t 

el 

e2 

el 

e 


FPOFF 

f  oon 

get  f 

get  num 

GRAPHCRT 

GRAPHELM 

GRAPHVEC 

head 

headot  r 

heat 

hoi  dx 

hoi  dy 

i  ndex 

inptrs 

i  ns  t  r 

instl-instSO 

inter 

int53 

i  nt60 

i  t  oa 

IXOFF 

IXON 

LCM 

1 cmho 1 d 

LER 

LEX 

LEI 

LE2 

LLR 

LLX 

LL1 

LL2 

LTA 

LTD 

1  ttr 

LXD 

mo  re  i  ns  t 

n0-nl7 

octbl 

out 

cause 

pick 

ol otpt 

dot  In 

pi  ot  h 

point 


po  i  n t  r 
proc  1 
proc2 
proc3 
proc^ 
proc5 
pt  rbuf f 
put  up 
qpt  r 
qpt  r  1 
at 

quest 
ql 

ramt ek 
RASTERD 
re t  c  ha  r 
scissor 
SCR 

sc  reen 
sc  ro 1  1 
SDCO 
set  mode 
set  up 
s  i  ze 

Sk  i  D 
SSCALL 
s  t  rout 
s t  rt  xy 
syst 0 1 
t b 1  who 
TRANSD 
triple 
upent 
vec  tor 
wait 
wDOFF 
WDON 
wr  i  ton 
xax  i  s 
x  m  i  n 
xmax 
y  a  x  i  s 
y ax  i  s  f 
ym  i  n 
ymax 
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APPENDIX  B:   USER  INTERFACE  ROUTINE  DESCRIPTIONS 

This  Apoendix  contains  the  descriptions  of  the  user 
interface  routines  in  the  format  that  is  followed  in  the 
documentation  of  the  UNIX  operating  system  in  the  Naval 
Postgraduate  School  Computer  Laboratory. 
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ax  1  s 


Jun  10  1976 


axis 


NAME: 


axis  -  draw  coordinate  axis 


SYNOPSIS: 

axis(x/v) 
float  x  ,  y  J 


DESCRIPTION: 

Draws  a  cartesian  coordinate  x  and  y  axis  on  the 
screen  with  center  at  user-defined  screen  coordinate 
(  x  ,  y  )  . 

The  operation  is  totally  independent  of  any  control 
mode  issued  previously. 

The  COP  is  left  at  (max  x-value»y).  Normal  return  is 
zero . 


DIAGNOSTICS: 

Returned   -1  indicates  no  oortion  of  the  axis  lies   on 
the  user-defined  screen. 
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bk  rnd 


Jun  10  1976 


bk  rnd 


NAME 


bkmd  -  change  reverse  background  flag 


SYNOPSIS: 

bkrnd (g) 
i  nt  g; 


DESCRIPTION: 

If   a  is  zero*  the  reverse  background  flag  in  the  con- 
trol mode  is  set  to  zero*  i.e.  turned  off. 

If   g   is  egual  to  one/  the  reverse  background  flag  in 
the  control  mode  is  set  to  one/  i.e.  turned  on. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned   -1   indicates   the   oassed   integer  g  is  not 
egual  to  zero  or  one. 
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bl  ock 


Jun  10  1976 


b  1  oc  k 


NAME: 


block  -  draw  solid  block 


SYNOPSIS: 

b 1 OCk ( x 1  , y  1  , x2, y2) 
f 1  oat  x  1  / y  1  ,  x2 ,  y2 ; 


DESCRIPTION: 

A  solid  block  is  drawn  with  opposite  corners  as  de- 
fined by  user-defined  screen  coordinates  (xl,yl)  and 
(x2,y2). 

The  COP  is  left  at  (x2fy2).  The  operation  is  indepen- 
dent of  any  mode  issued  previously  but  is  sensitive  to 
all  flags  applicable  to  Graphic  Cartesian  mode. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned   -1   indicates   the  block  can  not  be  drawn  on 
the  user-defined  screen. 


SEE  ALSO: 

indexO,  bkrndC),  dblwidO 
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chnge 


Jun  10  1976 


C  hnqe 


NAME: 


chnge  -  change  color  table  entry 


SYNOPSIS: 

chnge(numbfentry,cont) 
int  numb/  entry,  cont; 


DESCRIPTION: 

Changes  the  specified  entry  in  the  indicated  color 
table  to  the  passed  oarameter  cont.  triplet)  should 
be  used  to  put  cont  into  the  prooer  form. 

numb  is  the  table  number  in  which  the  entry  is  to  be 
changed.  entry  is  the  entry  number  to  be  changed. 
cont  is  the  integer  twelve  bit  code  which  is  loaded  in 
the  specified  entrv. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are     indicated  by  negative  returned   values. 
The  error  values  and  -their  meanings  are    as  follows: 

-1    Indicates  numb  is  less  than  four  or  greater   than 
seven  t  een . 

-2.    -     Indicates  entry  is  negative  or  greater  than   fif- 
t  een  . 


SEE  ALSO: 

triplet) 
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cl rtbl 


Jun  10  1976 


cl rtbl 


NAME: 


clrtbl  -  load  color  table 


SYNOPSIS: 

c 1 rtbl ( n , name ) 
i  n  t  n ,     *name  t 


DESCRIPTION: 

Loads  color  table  number  n  with  the  codes  contained  in 
the  array  pointed  to  by  name; 

The  array  is  an  integer  array  containing  sixteen  in- 
tegers which  represent  the  octal  code  of  the  color 
table  entries  between  zero  and  sixteen.  The  array  is 
assumed  to  be  declared  sixteen  words  in  length. 

n  is  an  integer  value  which  ranges  from  four  to  seven- 
t  een . 

The  color  tables  fro^  zero  to  four  are  system  defined 
tables.   They  contain  the  followina: 

Table  0  -  Fifteen  shades  of  grey. 

Table  1  -  Fifteen  shades  of  blue. 

Table  2    -  Fifteen  shades  of  green. 

Table  3  -  Fifteen  shades  of  red. 


If  the  user  desires   to   modify 
inter( ) . 


system   table   see 


/   Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  Dassed   integer   n   is   less 
than  four  or  areater  than  seventeen. 


SEE  ALSO: 

t  r  i  pi e  (  ) 
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color 


Jun  10  1976 


color 


NAME: 


color  -  se 1 ec  t  color 


SYNOPSIS: 

col  or ( s ) 
i  nt  s ; 


DESCRIPTION: 

The  passed  integer  s  is  the  number  of  the  entry  in  the 
current  color  table.  The  color  located  in  that  entry 
will  be  used  for  all  subseauent  entities  displayed 
until  a  different  color  is  issued. 

s  is  between  zero  and  fifteen. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  integer  s  is  negative 
or  greater  than  fifteen. 


SEE  ALSO: 

chnge ( ) 
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co 1 ort 


Jun  10  1976 


co 1  or t 


NAME: 


colort  -  select  display  color  table 


SYNOPSIS: 

col ort (t ) 
i  n  t  t ; 


DESCRIPTION: 

The   passed   Darameter   t   is   the  number  of  the  color 
table  that  is  sent  to  the  ramtek  device  for  display. 

t  is  between  zero  and  seventeen. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassed  integer  t  is  negative 
or  greater  than  seventeen. 


SEE  ALSO: 

cl rtbl  () 
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data 


Jun  10  1976 


data 


NAME: 


data  -  display  raw  data 


SYNOPSIS: 

dat  a ( name  > 1  ) 
i  n t  *name  r     1  ? 


DESCRIPTION: 

The  raw  data  oassed  in  the  linear  array  pointed  to  by 
name  is  displayed  on  the  ramtek  according  to  the 
current  control  mode. 

1  is  the  length  of  the  array  in  bytes! 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  integer  1  is  negative 
or  zero . 


SEE  ALSO: 

st  rout  O  f     1 1 1  r  (  ) 
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db 1 w  i  d 


Jun  10  1976 


db 1 w  i  d 


NAME: 


dblwid  -  change  double  width  flag 


SYNOPSIS: 

dbl wid(x ) 
i  n  t  x  ; 


DESCRIPTION: 

If  x  is  eaual  to  zero*  the  double  width   flag 
control  mode  is  set  to  zero,  i.e.  turned  off. 


in   the 


If  x  is  eaual  to  one.  the  douole   width   flag 
control  mode  is  set  to  one>  i.e.  turnea  on. 


in   the 


Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -I  indicates  the   passed   integer   x   is   not 
equal  to  zero  or  one. 


SEE  ALSO: 

s  i  ze  (  ) 
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erase 


Jun  10  1976 


erase 


NAME: 


erase  -  erases  the  screen 


SYNOPSIS: 

erase ( ) 


DESCRIPTION: 

The  ramtek  screen  is  erased  to  the  background  color  of 
the  color  table  currently  being  used. 
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f  i  xpt 


Jun  10  1976 


f  i  xpt 


NAME: 


fixpt  -  change  fixed  point  flag  in  control  mode 


SYNOPSIS: 

f i  xpt ( x  ) 
i  nt  x  ; 


DESCRIPTION: 

If  x  is  equal  to  zero?  the  fixed  point  flag  in  the 
control  mode  is  set  to  zero*  i.e.  turned  off. 

If  x  is  eaual  to  one*  the  fixed  ooint  flag  in  the  con- 
trol mode  is  set  to  one/  i.e.  turned  on. 

Meaningful  only  in  Graphic  Vector  or  Graphic  Plot 
mode.  In  Graohic  Vector  mode  it  causes  all  subsequent 
vectors  to  be  drawn  with  one  end  at  the  same  point  as 
issued  by  a  subseauent  or  last  previous  strtxy () .  See 
the  user's  manual  for  fixptO's  meaning  in  Graohic 
Plot. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned   -1   indicates   the   passed   integer  x  is  not 
equal  to  zero  or  one. 
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get  f 


Jun  10  1976 


get  f 


NAME: 


getf  -  read  floating  ooint  number  from  ramtek  keyboard 


SYNOPSIS: 

getf () 


DESCRIPTION: 

Returns  a  floating  Doint  number  from  the  ramtek  key- 
board. The  only  numbers  recognized  are:  an  optional 
minus  sign  followed  by  a  string  of  digits  optionally 
containing  one  decimal  point/  then  followed  ootionally 
by  the  letter  *e'  followed  by  a  signed  integer. 

Normal  return  is  the  floating  ooint  number. 


SEE  ALSO: 

aetnumOf  retcharO 
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get  num 


Jun  10  1976 


get  num 


NAME: 


getnum  -  read  number  from  ramtek  keyboard 


SYNOPSIS: 

get  num (base ) 
i  n t  base \ 


DESCRIPTION: 

Returns  a  positive  or  negative  integer  number  from  the 
ramtek  keyboard.  Numerals  typed  up  to  a  comma  or  a  c/r 
on  the  keyboard  are  considered  to  be  the  number.  The 
routine  will  not  return  any  value  until  a  c/r  or  a 
comma  is  typed*  nor  will  it  accept  characters  other 
than  digits  from  zero  to  nine  when  base  is  egual  to 
ten,  or  digits  from  zero  to  seven  in  case  of  base 
e  i  gh t  . 

base  is  the  base  of  the  integer  number  returned.  It 
is  restricted  to  eight  (octal)  or  ten  (decimal). 

Normal  return  is  the  inteaer  number. 


DIAGNOSTICS: 

All  errors  are     indicated  by  negative  returned   values. 
The  error  values  and  their  meanings  are    as  follows: 

-1    Indicates  a  c/r  was  struck  without   any   previous 
entries. 

-2    Indicates  the  oassed  oarameter  base  was  not  eaual 
to  eight  or  ten. 


SEE  ALSO: 

retcharO,  get  f ( ) 
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i  ndex 


Jun  10  1976 


i  ndex 


NAME: 


index  -  select  indexing 


SYNOPSIS: 

i  ndex ( i , x , y ) 
f  1  oat  x ,     y  ; 
int  i  ; 


DESCRIPTION: 

If  i  equals  zero*  indexing  is  deselected  and  the  in- 
dexing flag  in  the  control  mode  is  turned  off.  The 
index  registers  are  then  loaded  with  zero. 


/ 


If  i  eauals  one/  indexing  is  selected  and  the  indexing 
flag  in  the  control  mode  is  turned  on.  The  index 
registers  are  then  loaded  with  the  displacements 
oassed  in  x  and  y.  x  is  loaded  in  the  x-index  regis- 
ter and  y  is  loaded  in  the  y-index  register. 


x  must  be  no  greater  than  the  user-defined  screen 
width.  y  must  be  no  greater  than  the  user-defined 
sc  reen  height . 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are  indicated  by  negative  returned   values. 
The  error  values  and  their  meanings  are  as  follows: 

-1    Indicates  the  passed  integer  i  is   not   eaual   to 
zero  or  one . 

-2    Indicates  one  of  the  oassed  displacements  x  and  y 
is  greater  than  the  screen  height  or  width. 


SEE  ALSO: 

sc  reen ( ) 
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NAME: 


inter  -  interactive  color  table  .-modification  routine 


SYNOPSIS: 

i  nt er ( ) 


DESCRIPTION: 

Sets  up  and  runs  a  tutorial  program  that  enables  the 
user  to  look  at,  select  and  modify  color  tables  during 
orogram  execution.  There  are  two  basic  modes  in  which 
the  routine  operates.  Each  of  these  modes  has  a 
series  of  commands  which  the  user  can  execute. 

1.  Paqinq  Mode.  Upon  execution  the  paging  mode  is 
immediately  entered  and  a  set  of  instructions  is 
displayed.  The  following  commands  are  then  accept- 
able: 

'p'  -  Indicates  a  Darticular  table  number  is  to  be 
displayed.  The  number  must  then  be  entered 
between  zero  and  seventeen. 


-  Increments  table  number  displayed  by  one. 

-  Decrements  table  number  displayed  by  one. 

-  Displays  instructions. 

-  Quits  from  the  interactive  routine. 

-  Enters  the  edit  mode. 


2.  Edit  Mode.  When  the  edit  mode  is  entered*  a  set 
of  instructions  is  displayed  listing  the  commands  that 
can  be  issued  an^i  the  edit  method  they  initiate.  The 
c  ommands  a  re : 

*t'  -  Enters  table  assignment  method.  Permits 
entries  from  any  table  to  be  copied  into  the 
table  designated  by  the  user.  The  table 
number  which  is  to  receive  the  copied  en- 
tries must  be  entered  first. 

'  o '  -  Enters  octal  assignment  method.  Entries  are 
specified  in  a  designated  table  by  entering 
the  ordered  triple  that  defines  the  color 
desired.  The  table  number  (4-17)  in  which 
the  entries  are  to  be  defined  must  be  e  n  - 
t  ered  first. 


•c' 


-  Enters   combining   assignment   method.   This 
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method  allows  the  user  to  logically  OR  two 
separate  color  lookup  table  entries  into  a 
selected  user  table  entry.  Whole  tables  may 
also  be  combined  into  a  selected  user  table. 
The  user  table  number  (4-17)  must  be  entered 
first. 

'f'  -  Enters  inverting  tables  method.  This  methoo 
inverts  the  user  table  designated  by  the 
user.  Entry  zero  becomes  fifteen,  entry  one 
becomes  fourteen,  etc.  The  act  of  entering 
the  user  table  number  executes  the  inver- 
sion. 

'm*  -  Enters  copying  tables  method.  After  entry 
of  the  user  table  number  that  is  to  receive 
a  copied  table  the  number  of  the  table  to  be 
copied  is  entered.  The  act  of  entering  the 
second  table  number  causes  the  copy  to  take 
place. 

Upon  entry,  the  editing  methods  display  a  list  of 
instructions  on  how  the  method  is  to  be  used  and  the 
results  obtained.  Each  of  the  methods  have  commands 
that  may  be  issued.  .  The  legal  commands  for  each  edit 
method  are    summarized  below. 

-  Table  Assignment  Method. 

'n'  -  Indicates  the  table  number  and  entry 

to  be  copied  follows. 
'  c / r  '  -  I  nc r emen t s  through   the  entries 

in  the  receiving  user  table, 
'o'  -  Displays  the  color  lookuD  table  be- 

modified.   To  return  from  the  dis- 

ol  ay ,  t  yoe  a  ' g  '  . 
'q'  -  Quits  back  to  edit  mode  instructions. 


-  Octal  Assignment  Method. 


i  «. 


en- 


Indicates  the  octal  triple  to  be 
tered  as  the  entry  follows. 

'c/r'-Increments  through  the  entries 
in  the  receiving  user  table. 

'p'  -  Displays  the  color  lookuo  table  be- 
ing modified.   To  return  from  the 
di  spl ay ,  t  ype  a  *  g ' . 

'a'  -  Quits  back  to  edit  mode  instructions. 
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-  Combining  Assignment  Method. 

'n'  -  Indicates  the  two  ordered  pairs 
designating  the  table  number  and 
entry  number  to  be  OP'd  are    to  fol- 
1  ow  . 

1  c/ r  '  -Inc remen t s  through  the  entries  in 
the  receiving  user  table. 

'd'  -  Displays  the  color  lookup  table 
being  modified.  To  return  from 
the  display/  type  a  'q'. 

'w'  -  Indicates  two  whole  tables  are  to 
be  combined  (OR'd)  and  their  num- 
bers are    to  follow. 

'q*  -  Quits  back  to  edit  mode  instructions 


-  Inverting  Tables  Method. 

•p'  -  Displays  the  color  lookup  table  that 

is  being  or  was  inverted. 
'g'  -  Quits  back  to  edit  mode  instructions 

-  Copying  Tables  Method. 
-  Displavs  the  receiving  table. 


'p' 


-  Quits  back  to  edit  mode  instructions 
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NAME: 


Ittr  -  display  single  character 


SYNOPSIS: 

1 1 1  r (ch / s  i  ze ) 
i  n t  ch/  size? 


DESCRIPTION: 

Will  display  the  character  passed  with  the  size  indi- 
cated at  the  current  operating  point. 

After  display/  the  current  operating  point  is  on  the 
same  line  and  seven  actual  screen  elements  to  the 
right  of  its  last  position. 

ch  contains  the  ascii  code  for  the  character  to  be 
di  sp 1 ayed. 

If  size  is  equal  to  one/  the  character  is  disolayed  in 
st  anda  rd  size. 

If  size  is  equal  to  two/  the  character  is  displayed  in 
doub le  width  size. 

The  operation  is  independent  of  any  mode  issued  previ- 
ously/ but  is  sensitive  to  the  flags  applicable  to 
Alphanumeric  mode. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  Passed  integer  size  was   not 
equal  to  one  or  two. 


SEE  ALSO: 

stroutO/  data()/  sizeO/  index  ()#  bkrndC)/  writonO 
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NAME: 


ploth  -  plot  data  as  a  histogram 


SYNOPSIS: 

ploth(x,y,n,base) 
f 1  oat  *x ,     *y /  base  ? 
i  nt  n; 


DESCRIPTION: 

The  values  yfil  are  assumed  to  be  functions  of  x  C  U  • 
As  the  function  is  plotted?  the  area  between  the  curve 
and  the  x-axis,  as  designated  by  base/  is  filled  in 
with  the  color  last  selected. 

That  portion  of  the  histogram  that  lies  on  the  screen 
will  be  plotted. 

The  operation  is  totally  independent  of  any  control 
mode  issued  previously. 

x  and  y  are    pointers  to  linear  arrays, 
n  is  the  number  of  Doints  to  be  plotted. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All   errors  are    indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are    as  follows: 

Returned  -1  indicates  the  passed  parameter  base  is  not 
on  the  user-defined  screen. 


SEE  ALSO: 

pi ot 1 n  (  )  ,  ol otpt ( ) 
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NAME: 


plotln  -  plot  data  with  connected  lines 


SYNOPSIS: 

plot ln(x»y,n) 
f 1  oat  *x,  *y ; 
i  nt  n ; 


DESCRIPTION: 

.  The  values  ytil  are  assumed  to  be  functions  of  xCi], 
As  the  function  is  dotted/  the  successive  points  are 
connected  by  straight  lines  of  the  color  last  select- 
ed . 

That  portion  of  the  plotted  curve  which   lies   on   the 
screen  will  be  plotted. 

The  ODeration  is  totally  independent   of   any   control 
mode  issued  previously. 

x  and  y  are    pointers  to  linear  arrays, 
n  is  the  number  of  points  to  be  plotted. 


SEE  ALSO: 

ol ot h (  )  ,  pi otot  C ) 
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NAME: 


plotpt  -  plot  data  with  points 


SYNOPSIS: 

pi otpt ( x , y  r  n ) 
float  *x ,  *y ; 
i  n  t  n  ; 


DESCRIPTION: 

The  values  of  ytil  are  assumed  to  be  functions  of 
x  ( i  ]  .  The  function  is  plotted  with  dots  for  each 
(x[il,y[ij)  coordinate.  The  dots  are  the  color  last 
se 1 ec  ted. 

If  a  point  does  not  lie  on  the  user-defined  screen,  it 
i  s  not  pi ot  ted. 

The  operation  is  totally  independent  of  any  control 
mode  issued  previously. 

x  and  y  are  pointers  to  linear  arrays, 
n  is  the  number  of  points  to  be  plotted. 


SEE  ALSO: 

d1 oth  (  )  ,  pi ot 1 n  (  ) 
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NAME: 


point  -  define  point 


SYNOPSIS: 

point (x,y) 
float  x ,  y ; 


DESCRIPTION: 

Defines  a  point  on  the  user-defined  screen, 
must  lie  within  the  user-defined  streen. 


The  po  i  nt 


If  in  Graphic  Vector  mode*  (x/y)  defines  the  endpoint 
of  a  vector  and  causes  it  to  be  drawn.  The  current 
operating  point  is  then  (x,y). 

If  in  the  GraDhic  Element  <noder  (x»y)  defines  a  single 
point  on  the  user-defined  screen  and  causes  a  dot  to 
be  drawn  there.  The  current  ooerating  ooint  is  then 
(  x  /  y  )  . 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  ooint  does  not  lie  on 
the  user-defined  screen. 


SEE  ALSO: 

st  rt  xy  (  ) 
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NAME: 


pointr  -  define  a  point  relative 


SYNOPSIS: 

poi  nt  r ( x  f y  ) 
f 1  oat  x ,     y  ; 


DESCRIPTION: 

Defines  a  Doint  on  the  user-defined  screen  relative  to 
the  last  current  ooerating  point. 

If  in  Graphic  Vector  mode  a  vector  from  the  last 
current  operating  ooint  to  a  Doint  defined  by  the  last 
current  ooerating  point  plus  the  displacements  x  and  y 
i  s  drawn . 

If  in  Graphic  Element  mode  a  dot  is  drawn  at  a  point 
defined  by  the  last  current  operating  ooint  plus  the 
displacements  x  and  y. 

The  COP  is  left  at  the  calculatea   location. 


SEE  ALSO: 

st  rt  xy  (  ) 
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NAME: 


ramtek  -  initiates  ramtek  system 


SYNOPSIS: 

ramtek ( ) 


DESCRIPTION: 

Initiates   the  ramtek  system  and  sets  the  default  con- 
ditions as  follows: 

1  -   Initialize   the   user-defined   screen   to  0.0  to 

100.0  in  x  and  y . 

2  -   Loads   a   shades   of  grey  color  table  (0)  in  the 

ramt  ek . 

3  -   Selects  color  fifteen  in  table  zero  for  display. 

4  -   Selects  Alphanumeric  control  mode. 

5  -   Opens  the  ramtek  for  reading  and  writing. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1   indicates   ramtek   device   could   not   be 
opened . 
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NAME: 


retchar  -  read  a  character  from  ramtek  keyboard 


SYNOPSIS: 

retchar ( ) 


DESCRIPTION: 

An   asci  i   code   reoresenting   the   typed  character  is 
returned  in  the  lower  half  of  an  integer. 


SEE  ALSO: 

get  num ( ) ,    get  f ( ) 
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NAME: 


screen  -  define  user  screen 


SYNOPSIS: 

screenCxl ,y\ , x2 , y2) 
float  x 1 ,  y 1 ,  x2 ,    y2; 


DESCRIPTION: 

Defines   a  standard  cartesian  coordinate  system  of  any 

scale  for  the  user.  The   point   (xl,yl)   becomes   the 

coordinate   of   the  lower   left  corner  of  the  screen. 
The  ooint  (x2,y2)    becomes  the  coordinate  of  the   upper 

right  corner  of  the  screen. 

xl    must  be  strictly  less  than  x2. 

yl  must  be  strictly  less  than  y2. 


All  subsequent  user  coordinates  are 
cording  to  this  user-defined  screen. 


interpreted   ac - 


Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  xl  is  not  less  than  x2  or  yl  is 
not  less  than  y2.  An  error  message  is  also  printed  on 
the  terminal  screen. 
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NAME: 


scroll  -  scroll  screen 


SYNOPSIS: 

sc  rol 1  (3f cnt ) 
char  a / 
float  cnt ; 


DESCRIPTION: 

The  current  displayed  picture  on  the  screen  is 
scrolled  uo  or  down.  Information  scrolled  off  the  top 
of  the  screen  will  be  scrolled  in  the  bottom  and 
v  i  ce-versa . 

If  a  is  the  character  'd'/  the  direction  of  the  scroll 
will  be  down . 

If  a  is  the  character  'u'>  the  direction  of  the  scroll 
will  be  up . 

cnt  is  the  number  of  user-defined  y-units  that  the 
picture  is  to  be  scrolled.  cnt  can  be  no  larger  than 
the  screen  height. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All   errors  are    indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are    as     follows: 

-1    Indicates   the  passed  parameter  cnt  was  less  than 
zero  or  greater  than  the  screen  height. 

-2.  Indicates  the  passed  parameter  c  was  not  a  '  d  '  or 
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NAME: 


setmode  -  select  control  mode 


SYNOPSIS: 

setmode ( a  t b ) 
i  nt  a ,    b; 


DESCRIPTION: 

Selects  the 
oaramet  ers  a 
f ol lows: 


control   mode   according   to   the  passed 
and  b.   a  represents  the  control  mode   as 


0  -  A  1 phanumer  i  c 

1  -  Transverse  Data 

2  -  Raster  Data 

3  '  -  ComD lex  Data 

4  -  Graphic  Vector 

5  -  Graoh  ic  Plot 

6  -  Graphic  Cartesian 

7  -  Graphic  Element 

All  flags  are  turned  off  if  b  is  eaual  to  zero.  If  b 
is  equal  to  one/  any  flags  set  in  the  previous  mode 
are  also  set  with  the  mode  selected  by  a.  All  enti- 
ties displayed  subsequent  to  this  call  are  displayed 
according  to  the  selected  mode.  Routines  that  disre- 
gard the  selected  mode  are  axisO,  blockC)/  interO, 
lttrO,  olothO/  plotlnO,  olotptO  and  vectorO. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All   errors  are     indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are    as  follows: 

-1    Indicates   the   passed   parameter  a  was  less  than 
zero  or  greater  than  seven. 

-2    Indicates  the  passed  parameter  b  was  not  equal  to 
zero  or  one . 


SEE  ALSO: 

ramtekO;  bkrndO*  dblwidO, 
writonO 


f  i  x  p  t  (  )  /  indexOf 
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NAME 


size  -  select  letter  size 


SYNOPSIS: 

s  i  ze ( r ) 
i  n  t  r  ; 


DESCRIPTION: 

If  r  is  equal  to  one  the  standard   character   size   is 
used. 

If  p  is  eaual  to  two  the  double  width   character   size 
i  s  used. 

Sets  the   double   width   flag   in   the   control   mode. 
Therefore  size  takes  the  same  action  as  db 1 w i d ( ) . 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  parameter   r   is   not 
equal  to  one  or  two. 


SEE  ALSO: 

dbl  wi  d(  )  r     st  rout  Of  1  1 1  r  (  ) 
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NAME: 


st rout  -  output  character  string 


SYNOPSIS: 

st  rout ( sd) 
char  *sp; 


DESCRIPTION: 

Outputs  a  character  string  no  greater  than  100  charac- 
ters long  beginning  at  the  current  operating  point  and 
continuing  on  the  same  line.  After  completion,  an 
automatic  line  feed  occurs  which  defines  a  new  current 
operating  point  on  the  next  line  at  the  same  starting 
point  as  the  orevious  line. 

sp  points  to  the  character  string  to  be  output. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  string  contained  more  than 
100  characters.  In  this  case  no  characters  will  be 
di  sp 1 aved . 


SEE  ALSO: 

data( ) / 


si  ze(  )  ,     1  1 1  r ( ) 
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NAME: 


strtxy  -  establish  current  operating  point 


SYNOPSIS: 

st  rt  xy ( x , y  ) 
float  x ,     y ; 


DESCRIPTION: 

Establishes  the  current  operating  point  on  the  screen 
for  subseauent  instructions.  If  the  current  mode  is 
Graphic  Vector  with  the  fixed  point  flag  set*  it  es- 
tablishes the  base  from  which  the  vectors  are    drawn. 


x  is  a  user-defined  screen  location 
user-defined  screen  location  in  y. 


i  n 


i  s 


(x,y)  must  lie  within  the  user-defined  screen. 
Normal  return  is  zero. 


DIAGNOSTICS: 

Returned   -1  indicates  (x,y)  does  not  lie  on  the  user' 
defined  screen. 


SEE  ALSO: 

f  i  xpt  Of  screenOf  pointC) 
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NAME: 


tblwho  -  request  for  current  color  table  number 


SYNOPSIS: 

tbl who( ) 


DESCRIPTION: 

Returns  an  integer  value  which  is  the  table  number  of 
the  color  table  that  is  currently  being  used  for 
display. 
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NAME: 


triple  -  code  color  from  three  number  triple 


SYNOPSIS: 

t  r  i  pi e (b  r g#  r ) 
i  nt  b/g»  r ; 


DESCRIPTION: 

The  three  input  parameters  representing  the  amounts  of 
blue(b)/  green(g)  and  red(r)  are  coded  into  an  integer 
which  is  suitable  for  insertion  into  color  table  en- 
tries. 

b  is  between  0  and  15  and  represents  the  amount  of 
b 1 ue  des  i  red . 

g  is  between  0  and  15  and  represents  the  amount  of 
green  des  i  red . 

r  is  between  0  and  15  and  represents  the  amount  of  red 
des  i  red. 

Normal  return  is  an  integer  representing  the  code. 


DIAGNOSTICS: 

Returned   -1   indicates  input  parameters  bf     g  or  r  are 
negative  or  greater  than  15. 


SEE  ALSO: 

chnge( ) ,     c 1 rtbl ( ) 
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NAME: 


vector  -  draw  sinale  vector 


SYNOPSIS: 

vector(xl,yl r x2 , y2 ) 
float  xlr  y 1 ,     x2  ,  y2; 


DESCRIPTION: 

A  vector  is  arawn  on  the  screen  from  user-defined 
screen  coordinate  (  x  1  ,  y  1  )  to  (  x  2  ,  y  2  )  .  The  current 
operating  ooint  is  left  at  (x2/y2). 

The  ooerat ion  is  independent  of  any  mode  issued  previ- 
ously but  is  sensitive  to  the  flags  apDlicable  to  the 
Graphic  Vector  control  mode.  Undesired  results  may  be 
obtained  if  the  fixot  flag  is  set  previous  to  calling 
vector ( )  . 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  no  portion  of  the  indicated  line 
lies  on  the  user  defined  screen. 


SEE  ALSO: 

bkrndO,  dblwid,  fixotf)/  index() 
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NAME: 


writon  -  additive  write 


SYNOPSIS: 

wr  i  t  on ( w ) 
i  n  t  w  ; 


DESCRIPTION: 

If  w  is  a  oner  the  additive  write  flag  in  the  control 
mode  is  turned  on  causing  subseauent  entities  in 
A 1 Dhanumer i c *  Paster  Data  and  Transverse  Data  modes  to 
write  on  top  of  previous  entities  without  destroying 
them. 

If  w  is  a  zero*  the  additive  write  flag  in  the  control 
mode  is  turned  off. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  integer  w  is  negative 
or  greater  than  one. 


96 


REFERENCES 


[1]  Ritchie*  D.  M.f  "C  Reference  .Manual"/  Bell  Telephone 
Laboratories*  Murray  Hill/  Mew  Jersey  07974/  1975. 

12]  "Ramtek  GX-100B  Proaramminq  Manual"/  Ramtek  Corp./ 
1975. 

[3]  Aagner*/  F.  V.  and  LaHood/  J./  "Computer  Graphics  - 
Software  Design"/  o.  99-133*  "Computer  Graphics"/  ed. 
Gruenberger/  F.,  Thompson  Book  Company/  1967. 

in]  Sutherland/  I.  E./  "SKETCHPAD  -  A  Man-Machine  Graphical 
Communication  System",  AFIPS  Conf.  Proc./  Vol.  23/  p. 
329-346/  SJCC  1963. 

[51  Knowlton/  K.C./  "A  ComDuter  Technique  for  Producing 
Animated  Movies"/  AFIPS  Conf.  Proc./  Vol.25/  p. 
57-85/  SJCC  196a. 

[6]  Teitleman/  W  .  /  "Real  Time  Recognition  of  Hand-Drawn 
Characters"/  AFIPS  Conf.  Proc./  Vol.  26/  p.  559-575/ 
SJCC  1964. 

[7]  Jacks/  E.  L./  "A  Laboratory  for  the  Study  of  Graphical 
Man-Machine  Communication"/  AFIPS  Conf.  Proc./  Vol 
26/  p.  3a3-350,  SJCC  196a. 

[8]  Newman/  W.  M.  and  Sproull/  R.  F.,  "Principles  of 
Interactive  Cotnouter  Graphics"/  p.  359,  McGraw  Hill/ 
1973. 

[9]   "Ramtek   GX-100A   Proqramming   Manual"/   Ramtek   Corp./ 

197a. 


97 


INITIAL  DISTRIBUTION  LIST 


1.   Defense  Documentation  Center 
Came  ron  Stat  ion 
Alexanderia*  Virginia  22314 


No.  Cooies 
2 


2.   Library,  Code  0142 

Naval  Postgraduate  School 
Monterey,  California  93940 


Department  Chairman,  Code  52 
Department  of  Computer  Science 
Naval  Postgraduate  School 
Monterey,  California  93940 


Professor  George  A.  Rahe,  code  52Ra 
Department  of  Computer  Science 
Naval  Postgraduate  School 
Monterey,  California  93940 


LTJG  Gary  M.  Raetz,  USN,  Code  52Rr 
Department  of  Computer  Science 
Naval  Postgraduate  School 
Monterey,  California  939U0 


Commanding  Officer  Naval  Electronic 

Systems  Command 

Code  320 

Washington,  D.  C.  20360 

Attn:   CDR  Miller 


7.   1/Lt.  Roger  L.  Nesslage,  USMC 
12709  Col bv  Dri  ve 
Woodbridge,  Virginia  22192 


98 


- 


Thesis  1^5075 

rfN415     Nesslage 

N   c.l  The  design  of  a  user 

4  interface   for  a  color, 

raster   scan   graphics   de- 
vice, 

2  6  9  18 
i  7  F  2  7  4  6  1 

NOV  10  85  3  0612 


Thesi  s 

N415     Nesslage 

c.l  The   design  of  a  user 

interface   for  a  color, 
raster  scan   graphics  de- 
vi  ce. 


5 


thesN415 

The  design  of  a  user  interface  for  a  col 


3  2768  001  89910  7 

DUDLEY  KNOX  LIBRARY 


